std

The standard module is loaded by default. It provides core language constructs, contract interaction, control flow, and data manipulation.

Configuration variables

Config variables are set with set (fully qualified, including the module prefix) and are only readable by their own module and the user script.

Variable	Type	Default	Description
$std:tokenlist	string	https://api.evmcrispr.com/tokenlist/{chainId}	Tokenlist URL used to resolve token symbols (must be HTTPS).
$std:ipfsJwt	string	—	Pinata JWT used by @ipfs to upload content.

Commands

Command	Description
assert	Assert that an on-chain expression satisfies a comparison, on-chain.
batch	Group multiple commands into a single transaction.
def	Define a user command, helper, on-chain helper (def @name!), or module (def module <name> ( ...defs )), or return early from a command body (def return).
exec	Call a contract function, encoding the arguments from its signature.
exit	Stop script execution immediately.
if	Conditionally execute a block of commands, with an optional else block.
load	Load a module. Its commands and helpers become available qualified (mod:cmd, @mod:helper); an import list makes selected names available unqualified.
loop	Repeat a block: iterate over an array (loop $x of $arr), repeat until a condition is true (loop until <condition>), or exit/skip an iteration from inside the block (loop break, loop continue).
print	Log values to the console output. Arrays render as headerless tables: a flat array as one row, an array of arrays as one row per inner array.
send	Send a low-level transaction. Provide [to] for a call/transfer, --data for raw calldata, --value for native value, or any combination.
set	Assign a value to a variable for use later in the script.
sign	Sign a message or typed data with the connected wallet.
switch	Switch the active chain by name or ID.
wait	Wait for a duration before executing the next action (fork simulations advance the chain's clock instead).

Helpers

Helper	Returns	Description
@abi.decode	any	Decode ABI-encoded bytes into values given a comma-separated type list; a lens selects one of them.
@abi.decodeCall	any	Decode calldata into [contract signature [args]] with human-readable EVML values.
@abi.encode	bytes	ABI-encode values given a comma-separated type list, like Solidity abi.encode.
@abi.encodeCall	bytes	ABI-encode a function call from its signature and arguments.
@abi.encodePacked	bytes	ABI non-standard packed encoding, matching Solidity's abi.encodePacked.
@arr	array	Generate an array of sequential integers from start (inclusive) to end (exclusive).
@balance	number	Balance in base units: the native balance for ETH, or an ERC-20 balanceOf for any token symbol or address.
@block	array	[number, timestamp] of the latest or a specific block.
@bool	bool	Evaluate a boolean expression or convert a value to a boolean string.
@bytes	bytes	Convert a value to hex bytes, force UTF-8 encoding, or perform a bitwise operation.
@bytes32	bytes32	Pad a value to a 32-byte hex string. Integers and arithmetic expressions are left-padded like Solidity's bytes32(uint256(...)) cast; hex strings pad left by default or right with a trailing right.
@calc	number	Evaluate checked 256-bit integer arithmetic; use // for truncating division.
@calcCeil	number	Evaluate checked 256-bit integer arithmetic; root division rounds ceil.
@calcFloor	number	Evaluate checked 256-bit integer arithmetic; root division rounds floor.
@ceil	number	Evaluate exact rational arithmetic, round the final result toward positive infinity, and check its 256-bit integer range.
@date	number	Parse a date string into a Unix timestamp, with an optional offset.
@ens	address	Resolve an ENS name to its address.
@floor	number	Evaluate exact rational arithmetic, round the final result toward negative infinity, and check its 256-bit integer range.
@gas.estimate	number	Estimate the gas required for a contract call.
@gas.price	number	Current gas price in wei.
@get	any	Call a read-only contract function and return its result.
@hash	bytes32	Compute the hash of a string with keccak256 (default) or sha256.
@ifElse	any	A ternary over live reads: cond ? then : else, evaluating only the winning branch. Parenthesized ternaries nest as branches.
@ipfs	string	Upload text content to IPFS and return the CID.
@ipfs.get	string	Fetch content from IPFS, verified against its CID, and return it as text.
@me	address	Connected wallet address.
@nonce	number	Number of transactions sent from an address (its account nonce), read over plain RPC. For contracts it counts the CREATEs they performed. There is no on-chain form: the EVM has no nonce opcode.
@num	number	Evaluate exact rational arithmetic, truncate the final result toward zero, and check its 256-bit integer range.
@orElse	any	The value of the first read, or the second one when the first reverts.
@reverts	any	Whether a live call reverts: true when the chain refuses the call, false when it resolves; -!> matches the reason and a lens selects an error argument.
@sender	address	The account the current calls are sent from: the connected wallet (@me), or, inside a block that executes as another account, that account — the Safe in safe:propose and safe:execute, the last forwarder in aragonos forward, the DAO in aragonosx propose and act, the governor's executor (its timelock, else itself) in governor proposals and the timelock in timelock-schedule.
@sigValid	bool	Verify a signature against an expected signer address. Auto-detects EIP-712 typed data (JSON) vs. plain message.
@str	string	Convert a value to its string representation, or decode hex bytes as UTF-8.
@Ether	address	Resolve a token symbol to its contract address on the current chain.