DOCUMENTATION

Smart Account Integration

ERC-1271 and ERC-4337 requirements for native-XCN bridge intents.

Documentation

Tokenomics

Native-XCN withdrawal intents accept signatures from deployed ERC-1271 smart accounts.

Requirements

  1. senderAddress is the deployed smart-account contract on Onyx, not its owner EOA.
  2. The contract must validate isValidSignature(bytes32,bytes) with the ERC-1271 magic value.
  3. Register the intent before transferring XCN.
  4. Read the transfer destination from the intent response every time.
  5. Transfer the exact amountAtomic from the smart account to that destination.
  6. For ERC-4337, resolve the user operation to its final execution transaction and bind that transaction hash. A userOpHash is not an Onyx transaction hash.

Counterfactual or undeployed accounts and ERC-6492 wrapping are not documented as supported. Test the exact account implementation before enabling a production withdrawal path.