Skip to main content

TransactionsResource

Access via urblock.transactions.

Methods​

list(params?)​

List transactions.

const txs = await urblock.transactions.list({ limit: 10 });

Returns: ListResponse<TransactionListItem>

retrieve(id)​

Get a specific transaction.

const tx = await urblock.transactions.retrieve("tx_abc123");

Returns: TransactionResponse

mint(tokenId, params)​

Mint tokens to an address.

const tx = await urblock.transactions.mint("tok_abc123", {
  to: "0x...",
  amount: "1000000000000000000",
  idempotency_key: "mint-001",
});

Returns: TransactionResponse

transfer(tokenId, params)​

Transfer tokens.

const tx = await urblock.transactions.transfer("tok_abc123", {
  from: "0x...",
  to: "0x...",
  amount: "500000000000000000",
  idempotency_key: "transfer-001",
});

Returns: TransactionResponse

burn(tokenId, params)​

Burn tokens.

const tx = await urblock.transactions.burn("tok_abc123", {
  from: "0x...",
  amount: "100000000000000000",
  idempotency_key: "burn-001",
});

Returns: TransactionResponse

approve(tokenId, params)​

Approve a spender allowance.

const tx = await urblock.transactions.approve("tok_abc123", {
  owner: "0x...",
  spender: "0x...",
  amount: "1000000000000000000",
  idempotency_key: "approve-001",
});

Returns: TransactionResponse

transferFrom(tokenId, params)​

Transfer tokens on behalf of an owner (requires prior approval).

const tx = await urblock.transactions.transferFrom("tok_abc123", {
  spender: "0x...",
  from: "0x...",
  to: "0x...",
  amount: "500000000000000000",
  idempotency_key: "transfer-from-001",
});

Returns: TransactionResponse

burnFrom(tokenId, params)​

Burn tokens on behalf of an owner (requires prior approval).

const tx = await urblock.transactions.burnFrom("tok_abc123", {
  spender: "0x...",
  account: "0x...",
  amount: "100000000000000000",
  idempotency_key: "burn-from-001",
});

Returns: TransactionResponse

setTokenUri(tokenId, nftTokenId, params)​

Update the metadata URI for a specific NFT.

const tx = await urblock.transactions.setTokenUri("tok_abc123", 1, {
  token_uri: "ipfs://QmNewHash...",
  idempotency_key: "set-uri-001",
});

Returns: TransactionResponse

setRoyalty(tokenId, params)​

Set default royalty for a token contract (ERC-2981).

const tx = await urblock.transactions.setRoyalty("tok_abc123", {
  receiver: "0x...",
  fee_basis_points: 500, // 5%
  idempotency_key: "royalty-001",
});

Returns: TransactionResponse

setTokenRoyalty(tokenId, nftTokenId, params)​

Set per-token royalty (ERC-2981).

const tx = await urblock.transactions.setTokenRoyalty("tok_abc123", 1, {
  receiver: "0x...",
  fee_basis_points: 250, // 2.5%
  idempotency_key: "token-royalty-001",
});

Returns: TransactionResponse

setApprovalForAll(tokenId, params)​

Set or revoke operator approval for all tokens.

const tx = await urblock.transactions.setApprovalForAll("tok_abc123", {
  owner: "0x...",
  operator: "0x...",
  approved: true,
  idempotency_key: "approval-all-001",
});

Returns: TransactionResponse

setUri(tokenId, params)​

Set the URI for a specific token ID (ERC-1155).

const tx = await urblock.transactions.setUri("tok_abc123", {
  nft_token_id: 1,
  token_uri: "https://api.example.com/metadata/1.json",
  idempotency_key: "set-uri-001",
});

Returns: TransactionResponse

setBaseUri(tokenId, params)​

Set the base URI for an ERC-721 token.

const tx = await urblock.transactions.setBaseUri("tok_abc123", {
  base_uri: "https://api.example.com/metadata/",
  idempotency_key: "set-base-uri-001",
});

Returns: TransactionResponse