Skip to main content

Sale Bid

Make a purchase bid to acquire full ownership of an Ecosystem namespace. Completes the acquisition only if the owner’s sale offer is enabled. Any user may invoke this command, provided the sale listing is active.

open-token ecosystem sale-bid --help

Synopsis

open-token ecosystem sale-bid <Name>

Arguments​

ArgumentTypeRequiredDescription
<Name>StringYesTarget Ecosystem namespace name. No dot characters. Must be an existing, non‑expired on‑chain ecosystem. Owner must have an enabled sale offer (sale‑ask Enabled=1).

Behaviour​

  • Validates the target ecosystem’s sale offer is enabled. Fails with OfferDisabled if sale listing is turned off.
  • Validates ecosystem account exists and is not expired (NameExpired).
  • Reads on‑chain sell_price from the sale‑ask configuration.
  • Tokens equal to sell_price are transferred from bidder to ecosystem owner; treasury fees are deducted according to on‑chain configuration.
  • Full ownership of the ecosystem is transferred to the transaction signer (bidder).
  • Active usership lease (if present) remains fully valid and unchanged after ownership transfer. The renter continues to hold usership until rent expiry.
  • Does not modify ecosystem Meta, Body, ownership expiry timestamp, or existing rent state.
  • After successful purchase, the sale offer remains in its existing enabled/disabled state; the new owner may later run sale‑ask to update price or disable listing.

Constraints & Validation Rules​

  1. OfferDisabled: Ecosystem owner has not enabled the sale offer.
  2. NameExpired: Underlying ecosystem ownership registration is expired; purchase prohibited.
  3. NameTooLong / NameEmpty: Invalid ecosystem name input.
  4. InsufficientBalance: Bidder does not possess enough tokens to pay the configured sell price plus fees.

Usage Example​

Bid to purchase full ownership of ecosystem open:

open-token ecosystem sale-bid open