Cross-chain Product Integration

Explain XCM and cross-chain integration work flow with OAK Network


In this section, we will go over the steps of a cross-chain product integration. For example, the current work undergoing are,

In both products, Turing Network provides partners with Automation-as-a-service that comes with several technical benefits including

  • Oracle for time and price; Time is intrinsic to the chain and price is retrieved from aggregators such as DIA.
  • Task Storage
  • Task Invocation
  • On/off valve for each user

Integration Workflow

1. Define the product

1.1 Design questions

Our partner conversation usually starts with a few questions,

  1. Who are the target audience, or beneficial end users of this product?

    For example, the audience of Shiden <> Turing integration is all users on Shiden Network.

  2. What would be our product offering?

    Taking Dapp staking as an example, the feature would automate two operations, claim and deposit.

    Another example would be DEX liquidity pool reward compound, which will include three operations, claim, swap, and deposit.

  3. What are the user defined inputs?

    For auto-compound, normally the UI will need to ask users to provide some preferences, such as: - Frequency: how often to compound - Amount: percentage of claimed reward to compound (No need since the current re-deposit ratio is always 100%)

1.2 Picture the flow

After going through design decision calls, we will draw a high-level flow chart to picture the integration flow. For example, below is a diagram of a two-way XCM product integration. Two-way XCM product integration

1.3 UI/UX Design

We will also provide partners with product mockups as recommendation, and to mimic the end user experience as a guideline. For example, below are our mockups for Mangata LP reward auto-compound.

  1. After user turns on compound checkbox, navigate to Step 1, a one-time setup for user’s wallet, and ask to sign. Mangata integration Step 1

  2. After signing, move on to Step 2 in order to set up automation on Turing Network. Mangata integration Step 2

2. Define XCM Message

We will go over the details of the XCM message design in the XCM Message document, but here’s a template that our automation uses to send the task function call over for the target chain to execute.

let target_xcm =
        BuyExecution::<()> { fees: local_asset, weight_limit: Limited(xcm_weight) },
        Transact::<()> {
            origin_type: OriginKind::SovereignAccount,
            require_weight_at_most: transact_encoded_call_weight,
            call: transact_encoded_call.into(),
        DepositAsset::<()> {
            assets: Wild(All),
            max_assets: 1,
            beneficiary: MultiLocation {
                parents: 1,
                interior: X1(Parachain(T::SelfParaId::get().into())),

3. Define the fees

Fees are a big part of the product development, because there are several fees involved in the flow. If not implemented 100% accurately, small errors can accrue into bigger problems, such as insufficient balance for automation fees, or under-utilized residual balances.

3.1 Automation fees on Turing Network

First, there are two types of schedules defined in executionTimes of automationTime.scheduleXcmpTask

A. “Fixed” scheduling. User defines the number of occurrence and particular timestamps of a task. Three kind of fees need to paid on the scheduling.

  1. Inclusion fee - to include the task in Turing’s registry; charged at the scheduleXcmpTask call.
  2. Execution fee - to execute a task when time is right; also charged at the scheduleXcmpTask call. For example, if a user schedules a task to trigger 30 times, he would pay for the 30 execution fee upfront. (P.S. Refund is not implemented yet)
  3. Xcm fee - included in the execution fee. The Xcm fee is used to pay fees to the target chain when executing cross chain messages.

B. “Recurring” scheduling. This is the “good till cancel” option. The 3 fees are still there but the way in which they are charged are different.

  1. Inclusion fee is the same as that of “Fixed”.
  2. Execution fee - only one execution is charged at the scheduleXcmpTask call, and at the end of every execution, the next task will be scheduled and fee needs to be paid. It keeps going on till a user calls to cancel the task.
  3. Xcm fee is the same as that of “Fixed”.

    3.2 Execution fee on the target chain

    Since the execution of the task happens on the target chain, the partner needs to finalize the calculation method and send it off to Turing for implementation. Since we have done it repeatedly, we can help partners to determine their fee calculation.

4. Testing Procedure

4.1 Local Testing

The first step is for developers to spin up a relay chain and two parachain chains locally, build the bridge and test the integration.

  1. Build and run: Relay chain

    The goal is to run a local Rococo in this step, so clone the source code from the Polkadot repo.

  2. Build and run Turing

    Clone the source code from OAK-blockchain

  3. Build and run the target chain
  4. Run zombienet for local chains and HRMP channels

    The zombienet built by Parity can help us quickly spin up a relay chain, and two parachain networks and build channels. We recommend it for a quick-start.

    Follow the zombienet demo in our Github repo.

  5. Make sure XCM acknowledge and execution logic are implemented on the target chain.
  6. Run testing functions. For example, we wrote a Javascript e2e testing code for Mangata integration.

4.2 Testing on Rococo

The second step is to deploy both releases to Rococo parachains, build the bridge and test the integration.

  1. Release a new build and deploy it to Rococo parachains.
  2. Make sure assets involved are registered on both chains
  3. Establish HRMP channel between the two parachains.
  4. Run E2E testing

4.3 Testing on Kusama

In this final step of testing, we will follow below steps for deployment as well as end-to-end testing.

  1. Deploy the same build to Kusama parachain
  2. Make sure assets involved are registered on both chains
  3. Establish HRMP channel between the two parachains.
  4. Run E2E or manual testing

Javascript SDK oak.js
Establish HRMP channel with Turing