Skip to main content
These commands manage tape reservations: creating them, inspecting them, and growing them along either dimension, capacity or time. The tapes page covers the model behind them.

​
create

Reserves a tape on-chain and saves its keypair locally. Defaults to 5 GiB for 100 epochs. Pass --epochs <n> for an exact number of epochs, counting the current one, or --duration (12h, 7d, 4w) to buy enough epochs to last that long from now at the network’s current epoch duration. The new tape becomes the active tape for later commands unless you pass --create-only. This command spends TAPE immediately. It first checks that the wallet holds the TAPE cost and enough SOL for rent and fees, and stops with the amount needed if not. --dry-run prints the cost, estimated expiry, and wallet balance without reserving anything.
Output
The label is the address in a lowercase form, the bucket name S3 tools and subdomain serving use. The expiry time is an estimate from the current epoch duration. The TAPE cost is exact; the SOL figure estimates account rent and transaction fees. Without --out, the keypair lands in ~/.tape/cassettes/<tape-address>.json. Pass --overwrite-key to replace an existing file at the same path.

​
list

Lists every tape owned by the current wallet.
Output

​
info

Shows a tape’s on-chain state, including how many epochs remain and the estimated expiry time.
Output
remaining counts epochs from the current one to expiry. Once the current epoch reaches the expiry epoch, expires reads expired.

​
extend

Adds epochs to a tape’s reservation, either --epochs <n> or enough epochs to add a --duration such as 7d. Extension is permissionless: any wallet can pay to extend any tape, which is how data outlives its original owner (more on expiry). An expired tape cannot be extended. --dry-run shows the cost and new expiry without spending.
Output

​
resize

Grows a tape’s capacity, either by a delta or to a target total. The added capacity is charged for the epochs the reservation has left. --dry-run shows the cost without spending.
Output

​
delegate

Sets the tape’s write delegate: a second key allowed to register, certify, and delete tracks without owning the tape. This is how a hosted S3 gateway writes to your tape without ever holding your keypair (delegation).
Output

​
revoke

Removes the tape’s current write delegate.
info, extend, resize, delegate, and revoke accept --tape to target a tape other than the active one; create always makes a new one.