Configuring PostParams on Art Blocks Tokens

What Are PostParams?

PostParams (Post-Mint Parameters / PMP) are on-chain configurable parameters embedded in certain Art Blocks art scripts. After minting, authorized wallets can set values that directly affect the token's on-chain visual output — no re-mint required.

Each parameter has an authOption controlling who can configure it:

Token ID Format

\x3Ccontract_address>-\x3Ctoken_number>

Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78000000

Workflow

Step 1 — Discover available params

discover_postparams(tokenId, chainId?)

Returns: param keys, types, value constraints, current values, and authOption for each param. Always show this to the user before asking for values — they need to know what's configurable and within what constraints.

Step 2 — Build the configuration transaction

build_configure_postparams_transaction(tokenId, values, chainId?, signerAddress?)

• values is a key-value object — keys must match param keys from discover_postparams
• Always pass signerAddress when known — needed to determine artist status and validate authorization
• One transaction configures all passed params at once

Returns an unsigned transaction object ready to sign and submit.

Value Formats by Type

Notes

• Always call discover_postparams first — param keys and types are project-specific and not guessable
• String params: the configuringArtistString flag on the built transaction depends on whether signerAddress matches the project artist — always pass signerAddress for String type params
• Authorization: if the user's address doesn't match the authOption for a param, the transaction will revert on-chain. Check authOption against the user's role before proceeding
• One transaction per call, but you can configure multiple params in a single call by passing multiple keys in values