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
batch	Group multiple commands into a single transaction.
def	Define a user command, helper, or module (def module <name> ( ...defs )).
exec	Call a contract function, encoding the arguments from its signature.
halt	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) or until a condition is true (loop until <condition>).
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	array	Decode ABI-encoded bytes into values given a comma-separated type list.
@abi.decodeCall	array	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).
@block	any	Return [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.
@date	number	Parse a date string into a Unix timestamp, with an optional offset.
@ens	address	Resolve an ENS name to its address.
@gas.estimate	number	Estimate the gas required for a contract call.
@gas.price	number	Return the current gas price in wei.
@get	any	Call a read-only contract function and return its result.
@id	bytes32	Compute the keccak256 hash of a string (first 4 bytes for selectors).
@ipfs	string	Upload text content to IPFS and return the CID.
@ipfs.get	any	Fetch content from IPFS and return it as text.
@me	address	Return the connected wallet address.
@nonce	number	Get the transaction count (nonce) of an address.
@num	number	Evaluate an arithmetic expression or convert a value to a number.
@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.
@token	address	Resolve a token symbol to its contract address on the current chain.
@token.allowance	number	Fetch the allowance an owner has granted to a spender, in base units.
@token.amount	number	Convert a human-readable token amount to its base unit (applying decimals).
@token.balance	number	Fetch the token balance of an address in base units.
@token.decimals	number	Return the number of decimals of a token.
@token.format	string	Format a base-unit token amount as a human-readable string with the token symbol.
@token.symbol	string	Return the symbol of a token.
@token.totalSupply	number	Fetch the total supply of a token in base units.