Direct Withdrawal Cancellations

This guide walks you through cancelling a pending withdrawal order by calling cancelOrder() on the WithdrawQueue contract directly. It covers both direct cancellation (you submit the transaction) and meta-transaction cancellation (a relayer submits on your behalf).

How Cancellations Work

When you submitted a withdrawal order, the WithdrawQueue locked your account shares and minted an ERC-721 NFT to your address representing ownership of the order. To cancel:

Find your pending orders

Enumerate your order NFTs using the ERC-721 enumerable interface, then filter by PENDING status.

Cancel the order

Call cancelOrder(orderIndex). The contract verifies you own the order NFT, then returns your account shares to the refundReceiver address.

There is no approval step — the only requirement is that msg.sender holds the NFT for the given order.

Only orders with PENDING status (value 1) can be cancelled. Once an order has been fulfilled or is being processed, it cannot be cancelled.

What You’ll Need

Requirement	Description
Contract address	`withdrawQueueAddress` — see Account Discovery
ABI	Provided below
RPC endpoint	An Ethereum node URL
Private key or wallet	The same wallet that submitted the withdrawal order
Order index	From the `OrderSubmitted` event or NFT enumeration (shown below)

ABI Reference

[
  {
    "inputs": [{ "name": "orderIndex", "type": "uint256" }],
    "name": "cancelOrder",
    "outputs": [],
    "stateMutability": "nonpayable",
    "type": "function"
  },
  {
    "inputs": [
      { "name": "orderIndex", "type": "uint256" },
      { "name": "deadline", "type": "uint256" },
      { "name": "cancelSignature", "type": "bytes" }
    ],
    "name": "cancelOrderWithSignature",
    "outputs": [],
    "stateMutability": "nonpayable",
    "type": "function"
  },
  {
    "inputs": [{ "name": "orderIndex", "type": "uint256" }],
    "name": "getOrderStatus",
    "outputs": [{ "name": "", "type": "uint8" }],
    "stateMutability": "view",
    "type": "function"
  },
  {
    "inputs": [{ "name": "tokenId", "type": "uint256" }],
    "name": "ownerOf",
    "outputs": [{ "name": "", "type": "address" }],
    "stateMutability": "view",
    "type": "function"
  },
  {
    "inputs": [{ "name": "owner", "type": "address" }],
    "name": "balanceOf",
    "outputs": [{ "name": "", "type": "uint256" }],
    "stateMutability": "view",
    "type": "function"
  },
  {
    "inputs": [
      { "name": "owner", "type": "address" },
      { "name": "index", "type": "uint256" }
    ],
    "name": "tokenOfOwnerByIndex",
    "outputs": [{ "name": "", "type": "uint256" }],
    "stateMutability": "view",
    "type": "function"
  }
]

Contract Method Reference

`cancelOrder(orderIndex)`

Parameter	Type	Description
`orderIndex`	`uint256`	Index of the order to cancel. Get this from the `OrderSubmitted` event or by enumerating order NFTs.

`cancelOrderWithSignature(orderIndex, deadline, cancelSignature)`

For meta-transaction support — a relayer can cancel on behalf of the order owner.

Parameter	Type	Description
`orderIndex`	`uint256`	Index of the order to cancel
`deadline`	`uint256`	Unix timestamp after which the signature expires
`cancelSignature`	`bytes`	EIP-712 signature from the order owner (see Meta-Transaction Cancellation below)

ERC-721 Enumeration (finding your orders)

The WithdrawQueue is an ERC-721 contract. Each withdrawal order is represented by an NFT.

Method	Returns	Description
`balanceOf(owner)`	`uint256`	Number of order NFTs held by the address
`tokenOfOwnerByIndex(owner, index)`	`uint256`	The order index (token ID) at the given position
`ownerOf(tokenId)`	`address`	The current owner of a specific order NFT
`getOrderStatus(orderIndex)`	`uint8`	The order’s current status (see status table below)

Order Statuses

Value	Status	Cancellable?
`0`	NOT_FOUND	No
`1`	PENDING	Yes
`2`	COMPLETE	No
`3`	COMPLETE_PRE_FILLED	No
`4`	PENDING_REFUND	No
`5`	COMPLETE_REFUNDED	No
`6`	FAILED_TRANSFER_REFUNDED	No

Direct Cancellation Walkthrough

Find your order NFTs (read)

Get the number of order NFTs held by your address.

WithdrawQueue.balanceOf(yourAddress) → uint256 orderCount

If orderCount is 0, you have no orders to cancel.

Enumerate and filter pending orders (read)

Loop through your NFTs and check each order’s status.For each i from 0 to orderCount - 1:

WithdrawQueue.tokenOfOwnerByIndex(yourAddress, i) → uint256 orderIndex
WithdrawQueue.getOrderStatus(orderIndex) → uint8 status

Only orders with status == 1 (PENDING) can be cancelled.

Cancel the order (transaction)

Call cancelOrder() for each pending order you want to cancel.

WithdrawQueue.cancelOrder(orderIndex)

The contract:

Verifies that msg.sender owns the order NFT
Returns the locked account shares to the refundReceiver address (set during order submission)
Burns the order NFT

Wait for the transaction to be mined. Your account shares are now unlocked and available.

Verify cancellation (read, optional)

Confirm the order status changed.

WithdrawQueue.getOrderStatus(orderIndex) → uint8 status

Expected: 5 (COMPLETE_REFUNDED)

If you already know the orderIndex (e.g., you saved it from the OrderSubmitted event when you submitted the withdrawal), you can skip Steps 1–2 and go directly to cancellation. Just verify the order is still PENDING first.

Meta-Transaction Cancellation

For relayer or gasless cancellation, the order owner signs an EIP-712 message off-chain and anyone can submit the transaction.

EIP-712 Type

Cancel(uint256 orderIndex, uint256 deadline, address queueAddress, uint256 chainId)

Walkthrough

Build the EIP-712 typed data (off-chain)

EIP-712 Domain:

Field	Value
`name`	`"WithdrawQueue"`
`chainId`	Chain ID (e.g., `1`)
`verifyingContract`	WithdrawQueue address

Cancel message:

Field	Value
`orderIndex`	The order to cancel
`deadline`	Unix timestamp (e.g., now + 1 hour)
`queueAddress`	WithdrawQueue address
`chainId`	Chain ID (e.g., `1`)

Sign the typed data (off-chain)

The order owner signs the EIP-712 typed data using their wallet’s signTypedData method. This produces a 65-byte signature.

Submit via relayer (transaction)

Anyone can submit the cancellation using the owner’s signature:

WithdrawQueue.cancelOrderWithSignature(
  orderIndex,        // the order to cancel
  deadline,          // from the signed message
  cancelSignature    // 65-byte EIP-712 signature
)

The contract verifies the signature came from the order NFT owner and that the deadline hasn’t passed.

The deadline in the signed message and the deadline passed to cancelOrderWithSignature() must match exactly. If the current block timestamp exceeds the deadline, the transaction will revert with SignatureExpired.

Troubleshooting

OnlyOrderOwnerCanCancel

Your wallet doesn’t own this order’s NFT. Only the original submitter (or whoever holds the NFT) can cancel.

InvalidOrderType

The order isn’t in PENDING status. Check getOrderStatus() — only status 1 is cancellable.

InvalidOrderIndex

The order index doesn’t exist. Verify it from the OrderSubmitted event or NFT enumeration.

SignatureExpired

The deadline in cancelOrderWithSignature has passed. Generate a fresh signature with a future deadline.

Next Steps

Direct Deposits — Deposit tokens into an account
Direct Withdrawals — Submit a withdrawal order
Account Queries & Monitoring — Read APY, TVL, check balances, and monitor withdrawal status
SDK Withdrawals Guide — Cancel via the Amplify SDK instead

Getting started

Amplify

USDG0

Direct Withdrawal Cancellations

How Cancellations Work

What You’ll Need

ABI Reference

Contract Method Reference

`cancelOrder(orderIndex)`

`cancelOrderWithSignature(orderIndex, deadline, cancelSignature)`

ERC-721 Enumeration (finding your orders)

Order Statuses

Direct Cancellation Walkthrough

Meta-Transaction Cancellation

EIP-712 Type

Walkthrough

Troubleshooting

Next Steps

​How Cancellations Work

​What You’ll Need

​ABI Reference

​Contract Method Reference

​cancelOrder(orderIndex)

​cancelOrderWithSignature(orderIndex, deadline, cancelSignature)

​ERC-721 Enumeration (finding your orders)

​Order Statuses

​Direct Cancellation Walkthrough

​Meta-Transaction Cancellation

​EIP-712 Type

​Walkthrough

​Troubleshooting

​Next Steps

How Cancellations Work

What You’ll Need

ABI Reference

Contract Method Reference

`cancelOrder(orderIndex)`

`cancelOrderWithSignature(orderIndex, deadline, cancelSignature)`

ERC-721 Enumeration (finding your orders)

Order Statuses

Direct Cancellation Walkthrough

Meta-Transaction Cancellation

EIP-712 Type

Walkthrough

Troubleshooting

Next Steps