Supply Chain Custody Transfer Tool

WHAT IT DOES

The Supply Chain Custody Transfer Tool enables users to transfer custody of supply chain assets on-chain. It reads custody registry contract state, user address, wallet balance, and asset/token state including product ID and batch number. The tool processes current custodian, transfer parameters such as new custodian and transfer reason, gas price, base fee, block timestamp, chain ID, transaction nonce, approval state, contract owner state, and custody status. It supports transferCustody for standard transfers, batchTransferCustody for multiple transfers in one transaction, and custodyHandover for simplified handover workflows. The tool reads the custody status before execution.

HOW TO USE

Connect your wallet and select the target network. Enter the custody registry contract address and the asset ID (product or batch identifier). Provide the current custodian address (must match your wallet) and the new custodian address. Optionally enter a transfer reason. Choose the execution method (transferCustody, batchTransferCustody, or custodyHandover). The tool will fetch the custody status and display the current custodian and active status. Once confirmed, it submits the custody transfer transaction. The tool validates that the current custodian matches your wallet before signing.

TECHNICAL MECHANISM

Unlike generic transfer tools, this executor is purpose-built for supply chain custody workflows. It first reads the registry contract's isActive() to ensure the contract is operational. The tool fetches the custody status via getCustodyStatus() to display the current custodian and whether the asset is active. It validates that the current custodian matches the caller's address to prevent unauthorized transfers. The tool selects the optimal method: transferCustody for standard transfers with reason, batchTransferCustody for multiple assets in one transaction, or custodyHandover for simplified handover with minimal parameters. The transfer reason is stored as a string for audit purposes. Gas costs are calculated using receipt.effectiveGasPrice for accurate post-EIP-1559 fee accounting. The tool displays the custody status before and after the transfer.

WHAT IT CANNOT SEE

This tool cannot verify that the physical asset has been transferred or that the new custodian has accepted the transfer. It cannot detect off-chain custody changes or verify the condition of the asset. It also cannot guarantee that the transfer will be recognized by other supply chain participants. The tool cannot verify the identity of the new custodian or detect if the asset has been damaged. It also cannot detect if the registry has been paused or upgraded.

PLEASE NOTE

This tool supports EVM-compatible chains. Transferring custody is a serious action—verify all addresses and the asset ID before signing. The custody registry contract must implement the transfer functions expected by this tool. The current custodian must match the caller's address. Batch transfer requires arrays of asset IDs, custodians, and reasons. This tool does not verify physical transfers—it only records custody changes on-chain. For provenance attestation, use the Supply Chain Provenance Attestation Tool.