Skip to main content

Rent Bid

Submit a bid to take usership lease on an Entity resource. Creates an active rental lease if the entity’s usership offer is enabled. Any user may invoke this command, provided the rental listing is open and no existing active lease exists.

open-token entity rent-bid --help

Synopsis

open-token entity rent-bid <Name> <Days>

Arguments​

ArgumentTypeRequiredDescription
<Name>StringYesTarget entity resource name (e.g. oppen://google.com, open://app.google.com). Must be an existing non‑expired on‑chain entity account. Corresponding human‑readable URI: open://google.com, open://app.google.com. Entity owner must have an enabled usership offer.
<Days>u32YesRequested lease duration in calendar days. Subject to program‑enforced minimum and maximum rent duration limits. Total rent cost = rent_per_day × days, charged in base token units.

Behaviour​

  • Validates that the target entity’s usership offer is enabled (Enabled = 1). Fails if offer is disabled.
  • Validates entity account exists and is not expired (NameExpired).
  • Validates parent Ecosystem namespace exists on‑chain (ParentNotCreated).
  • Rejects if there is already an active ongoing usership lease (AlreadyRented); one lease per entity at a time.
  • Total rent amount is calculated from on‑chain rent_per_day multiplied by input <Days>. Tokens are transferred from bidder to entity owner plus applicable treasury fees.
  • Creates new active usership lease record; transaction signer becomes the new renter (tenant).
  • Lease expiry timestamp = current block clock unix timestamp + Days × 86400 seconds.
  • Does not change entity ownership, meta, body content, or entity ownership expiry timestamp.
  • After lease expiry, usership privileges are automatically revoked; full usage rights revert back to entity owner, new rent‑bid is permitted.
  • Logical resolution note: Even with valid entity usership lease, the entity cannot be resolved via open:// scheme if its parent Ecosystem is expired.

Constraints & Validation Rules​

  1. OfferDisabled: Entity owner has not enabled the usership offer (rent‑ask Enabled=0).
  2. AlreadyRented: An active usership lease is already in effect for this entity.
  3. DaysTooSmall: Requested lease days below program‑defined minimum rent duration.
  4. RentTooLong: Requested lease days exceed program‑defined maximum rent duration.
  5. NameExpired: Underlying entity ownership registration is expired; rent‑bid prohibited.
  6. ParentNotCreated: Parent Ecosystem namespace does not exist on‑chain.
  7. MaxEntityLevelIsFour: Entity name hierarchy depth exceeds program‑defined maximum level.
  8. NameTooLong / NameEmpty: Invalid entity name input.
  9. InsufficientBalance: Bidder does not hold enough tokens to cover total rent payment.

Usage Example​

Bid to acquire usership on entity open://google.com for 45 days:

open-token entity rent-bid open://google.com 45