Skip to main content
Automated Onchain Actions let you specify a smart contract call that executes automatically the moment settled funds arrive on the destination chain. You define the target contract, the function to call, and any custom parameters — Rhino handles everything else.
This is a premium Extension. Your account must have Automated Onchain Actions enabled before the postBridgeData field will be accepted on quote or SDA generation requests. Contact your account representative to enable it.

​
The result: a single deposit produces a fully activated on-chain outcome — no additional steps from your user or your system.

​
How It Works

Enabling an Automated Onchain Action requires no additional API calls or integration steps. You simply include a postBridgeData field in your bridge quote or Smart Deposit Address generation request. We take care of the contract approval, encoding, execution, and error handling on the destination chain. The postBridgeData field accepts:
  • Tag under _tag that specifies the Automated Onchain Action you want to execute
  • Optional custom parameters to specify a custom target like vault, user ID or invoice ID
We configure everything else: tokens and amounts, contract specific inputs, token approval, amount injection, gas estimation, and execution sequencing.

​
Use Cases

Automated Onchain Actions apply wherever you need a defined on-chain outcome rather than just a token credit. Common patterns: Yield and protocol integrations Deposit bridged funds directly into a vault, lending pool, or staking contract. The user’s recipient address receives the protocol’s output token (e.g. vault shares, staked positions). Custodial and off-chain crediting For custodial platforms and exchanges, Automated Onchain Actions can trigger a contract that signals an off-chain system like crediting a user’s account, updating a balance, or notifying a clearing layer, without requiring the user to interact with your chain/system directly. Payments and holding accounts Trigger a contract that routes funds to a payment processor, holding account, or escrow. Useful for on-chain invoicing, subscription flows, or multi-party settlement. In all cases, the integration surface is the same: one additional field on a request you’re already making.

​
Integration

​
With a Bridge Quote

Add postBridgeData to your POST /bridge/quote/user request body: 
{
  "token": "USDC",
  "chainIn": "ARBITRUM",
  "chainOut": "BASE",
  "amount": "100.5",
  "mode": "pay",
  "depositor": "0x0",
  "recipient": "0x0",
  "postBridgeData": {
    "_tag": "postBridgeActionTag",
    "userId": "1"
  }
}
The destination token and amount is injected automatically into the matching function argument. You only need to specify the unique tag and any custom parameters like userId in the example above.

​
With a Smart Deposit Address

Add postBridgeData to your POST /sda/deposit-addresses request. Every deposit to that address will trigger the same action automatically — no per-deposit configuration needed. 
{
  "depositChains": ["ARBITRUM", "BASE", "ETHEREUM"],
  "destinationChain": "BASE",
  "destinationAddress": "0x0",
  "postBridgeData": {
    "_tag": "postBridgeActionTag",
    "userId": "1"
  }
}
This is the recommended pattern for onboarding flows. Generate an SDA per user with their recipient address baked in, and every inbound deposit routes directly to the target contract outcome.

​
The postBridgeData Field

FieldTypeRequiredDescription
_tagstring✓Specifies the Automated Onchain Action configuration.
optional custom paramsstring / integer-Specifies a custom target like a user, merchant or payment

​
Example — Bridge into a Morpho Vault

A user holds USDT on Arbitrum and wants to enter a USDC yield vault on Base. Without Automated Onchain Actions, they would need to: swap USDT → USDC, bridge to Base, approve the vault, and call deposit() themselves — four to five steps across two chains. With Automated Onchain Actions + SDA, you generate one deposit address per user. They send USDT on Arbitrum. We swap, bridge, and execute the vault deposit. Their wallet receives vault shares on Base. 
curl -X POST https://api.rhino.fi/sda/deposit-addresses \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "depositChains": ["ARBITRUM", "ETHEREUM", "BASE"],
    "destinationChain": "BASE",
    "destinationAddress": "0x0",
    "postBridgeData": {
      "_tag": "Morpho",
      },
    "tokenOut": "USDC"
    }
  }'
Just hand the user the returned depositAddress for any of the supported source chains. They send funds. The vault deposit happens automatically. In the example above, the user can send USDC or USDT on Arbitrum, Ethereum and Base (yes, same chain works as well). We process any supported token and your user ends up with Morpho USDC yield token on Base with on the specified destination address.

​
What Happens If the Action Fails

If the contract call reverts on the destination chain, funds are not lost. Depending on your account configuration, we will either retry (for transient failures), credit the destination token directly to the destinationAddress, or notify you via webhook and await instructions. Test your contract integration before going live. Contact your account representative to enable testnet access.

​
Limitations

  • ERC-20 type tokens only — native gas tokens (ETH, SOL, etc.) cannot be the input to an Automated Onchain Action yet
  • One action per bridge — chaining multiple contract calls in sequence is not currently supported
  • EVM destination chains only — non-EVM destinations (i.e. Solana) are on the roadmap
  • Automated Onchain Actions must be enabled on your account — the postBridgeData field is accepted only on accounts with this Extension active. Contact your account representative to enable it.

​
Next Steps