Skip to main content
Use thru-cli program when you are working with managed programs rather than raw uploader buffers.

Use This When

  • you want to create or upgrade a managed program from a binary
  • you need to pause, finalize, destroy, or inspect a managed program
  • you need address derivation helpers such as seed-to-hex or manager account derivation
Choose another family when:
  • you want raw upload-buffer lifecycle commands: Uploader Commands
  • you want to publish or inspect ABI accounts: ABI

Commands

CommandUse it for
createUpload a binary and create a managed program.
upgradeUpload a new binary for an existing managed program.
set-pausePause or unpause a managed program.
destroyDestroy a managed program and its meta account.
finalizeMake a managed program immutable.
set-authoritySet a new authority candidate.
claim-authorityClaim authority as the candidate.
derive-addressDerive a program address from a program ID and seed.
derive-manager-accountsDerive both manager metadata and program accounts from a seed.
seed-to-hexConvert a UTF-8 seed into a zero-padded 32-byte hex string.
derive-program-accountDerive the managed program account only.
statusInspect program and related manager accounts.

High-Signal Flags

FlagWhy it matters
--managerOverride the configured manager program ID.
--ephemeralSwitch derivation and lifecycle to ephemeral program mode.
--authorityChoose the configured authority key for program creation.
--fee-payerOverride the signer used for destructive or finalizing actions.
--chunk-sizeControl upload chunk size for create and upgrade.

Minimal Patterns

thru-cli program seed-to-hex my_program
thru-cli program create my_program ./build/thruvm/bin/my_program_c.bin
thru-cli program status my_program

Notes

  • For seed conversion, the correct command is thru-cli program seed-to-hex, not a top-level seed-to-hex.
  • Start with status when you need to understand whether a seed already has live manager or program accounts.
  • Reach for uploader only when you intentionally want the lower-level upload account flow.