Required Installations

You need foundry (for the chain tooling) and jbang (to start a web service with the renderer). For installation instructions see the setup page. Apart from this we assume that openssl, cat, tr, xxd and sed are present.

The following commands should be run in a shell (macOS Terminal, Windows GitBash). You may use the copy button and just paste them into the shell.

Deployment of the Router/Demo Contract

0xcA7E032a351D654c00A8262BCb1Fe01c8c351203

0x07f873654A0C7aDfe2F2DBA0d5d453DEf263dB60

0xdd3292f3743002CA4e2F637C09D4b6C11F1fA094

0xBEFA3d598cC127b8Bc7b9E2dCDc29349d68a39A4

Preparation a): Open Remix

Open re-mix via the follwing URL

👈 *If you click the badge, Remix will open, load the interface definition of the router/demo contract ICallDecryptionOracleRouterDemo.sol and compile it.

Preparation b): Connect your wallet and select the router/demo conteract.

• Connect your wallet (Environment -> Browser extension -> Injected Provider) (with the correct network).
• Fill in the address of the router ($ROUTER above, depending on the network) in At Address and click on At Address.
• Checkout the functions under Deployed Contracts.

0) Generate encrypted hashed arguments

For a step-by-step introduction on how to generate the required componens, i.e.,

see the usage page. Here we have all steps a bit more condensed. Execute the following parts in a shell.

First, select the RPC and the Demo Contract addresses for the desired network. Set

RPC_URL="https://ethereum-rpc.publicnode.com"
ORACLE_CONTRACT=0x13E6464A85a63c9214a4F04cd942466F35D17E54
ROUTER_CONTRACT=0xcA7E032a351D654c00A8262BCb1Fe01c8c351203

RPC_URL="https://polygon-rpc.com"
ORACLE_CONTRACT=0x22a687a3a0F958AccC1395C4D134F297eaCa1B2B
ROUTER_CONTRACT=0x07f873654A0C7aDfe2F2DBA0d5d453DEf263dB60

RPC_URL="https://ethereum-sepolia-rpc.publicnode.com"
ORACLE_CONTRACT=0x668a5e0eE0dD80F08AE7cf7D91Af84d6bB28f70D
ROUTER_CONTRACT=0xdd3292f3743002CA4e2F637C09D4b6C11F1fA094

RPC_URL="https://rpc-amoy.polygon.technology"
ORACLE_CONTRACT=0x27aF9135aF9a7FEe7f9dde4d595E200B0c602576
ROUTER_CONTRACT=0xBEFA3d598cC127b8Bc7b9E2dCDc29349d68a39A4

Pasting the follwing lines in your shell (e.g. bash) will generate the ecrypted arguments for (uint256) 20, (string) “Peach” (uint256) 990. It will construct a call descriptor for a function that has that signature.

ARGS_PLAIN=$(cast abi-encode "func(uint256,string,uint256)" 20 "Peach" 990)

ARGS_HASH=$(cast keccak "$ARGS_PLAIN")
export ARGS_DESCRIPTOR=$(cast abi-encode "wrap(address[],bytes)" [] $ARGS_PLAIN)
export ORACLE_PUBLIC_KEY=$(cast call "$ORACLE_CONTRACT" "getPublicKey()(bytes,bytes32)" --rpc-url "$RPC_URL" | head -n 1)
ENCRYPTED_ARGS=$(jbang net.finmath:finmath-decryption-oracle-base:2.5.5:cli)

FEE_CALL_DECRYPT=$(cast call "$ORACLE_CONTRACT" "feeCall()(uint256)" --rpc-url "$RPC_URL")
ECHO $FEE_CALL_DECRYPT

DEMO_TARGET_CONTRACT=$ROUTER_CONTRACT
DEMO_TARGET_METHOD="demoTargetFunction"
DEMO_TARGET_VALID_UNTIL_BLOCK=0
DEMO_SELECTOR=$(cast sig "$DEMO_TARGET_METHOD(uint256,string,uint256)")
DEMO_CALL_DESCRIPTOR=$(cast abi-encode "CallDescriptor(address,bytes4,uint256)" $DEMO_TARGET_CONTRACT $DEMO_SELECTOR $DEMO_TARGET_VALID_UNTIL_BLOCK)

printf "\n\n\e[1mDemo Call Descriptor:\e[0m\n$DEMO_CALL_DESCRIPTOR\n\n\e[1mDemo Encrypted Arguments:\e[0m\n$ENCRYPTED_ARGS\n\n\e[1mArgs Hash:\e[0m\n$ARGS_HASH\n\n\e[1mFee (for Decrypt) in Wei (1E18):\e[0m\n$FEE_CALL_DECRYPT\n\n"

1) Store the encrypted hashed arguments in the demo contract

• Expand the arguments under the store method.
• Enter a chosen clientId, the encrypted arguments (encArgs) and the hash (argsHash) in store and hit transact.
• Once the transaction is completed, enter your chosen clientId in getResults and hit call.

👉 This will show you updated values of (phase, caller, targetContract, argsEncrypted, argsHash).

2) Trigger the execution with decrypted arguments

• Enter your chosen clientId in decrypt and hit transact.
• Once the transaction is completed, enter your chosen clientId in getResults and hit call

👉 This will show you updated values of (phase, requestId).

⚠️ IMPORTANT: The function decrypt is payable. It may be required that you send a small fee to cover the cost of the call back. If a fee is required it is reported in the above definition of $FEE_CALL_DECRYPT. The fee is in Wei (so 1/1E18 of an ETH or POL) and has to be put in the value-field.

Note: You should observe phase: 2 which indicates that the contract requested decryption of the arguments. Once the decrypted arguments were deliverd to the callback you should observe phase: 3, however, sometimes it takes a while until remix reflects this - you can move to the next step.

If the callback is reflected you will see updated values of (phase, argsPlain, argsHashComputed).

3) Trigger the routing of the decrypted arguments to a buisiness logic function (typed arguments)

• Enter your chosen clientId in execute and hit transact.

• Once the transaction is completed, enter your chosen clientId in getResults and hit call

👉 This will show you updated values of (routingSuccess).

• Enter your chosen clientId in getResultsDemo and hit call

👉 This will show you updated values of (arg1, arg2, arg3).