Build with ARL

1. The client creates a job for a provider, with a deadline.
2. Client or provider sets the budget (in ARL or USDC).
3. The client funds it: the budget is locked in the escrow.
4. The provider submits the work (a link or a hash).
5. The evaluator (the client by default) completes the job, which pays the provider, or rejects it, which refunds the client. After the deadline only a refund is possible.

In n8n open Settings → Community Nodes → Install and enter n8n-nodes-arl. Add an ARL Wallet API credential (a dedicated wallet’s key and a Base RPC URL), then use the ARL node: Create Job, Set Budget, Fund Job, Submit Work, Complete Job, Reject Job, Claim Refund, Get Job. n8n-nodes-arl on npm

npm install arl-protocol-sdk viem

import { createJob, setBudget, fundJob, settleJob, ESCROWS } from "arl-protocol-sdk";
import { createPublicClient, createWalletClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.ARL_WALLET_KEY);
const clients = {
  publicClient: createPublicClient({ chain: base, transport: http() }),
  walletClient: createWalletClient({ account, chain: base, transport: http() }),
};

const { jobId } = await createJob(clients, ESCROWS.ARL, {
  provider: "0xProvider", hoursUntilDeadline: 24, description: "Summarise 10 documents",
});
await setBudget(clients, ESCROWS.ARL, BigInt(jobId), "10");   // 10 ARL
await fundJob(clients, ESCROWS.ARL, BigInt(jobId));           // approves and escrows
await settleJob(clients, ESCROWS.ARL, BigInt(jobId), "complete", "checked"); // pays

The SDK also streams compute payments per second, buys ARL in the official pools and runs verified jobs. arl-protocol-sdk on npm

pip install web3

import os, time
from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://mainnet.base.org"))
me = w3.eth.account.from_key(os.environ["ARL_WALLET_KEY"])
ESCROW = "0x4664d58FAFFb6ab1cf36717c70058a323E2A98f9"
ABI = [
  {"name": "createJob", "type": "function", "stateMutability": "nonpayable",
   "inputs": [{"name": "provider", "type": "address"}, {"name": "evaluator", "type": "address"},
              {"name": "expiredAt", "type": "uint256"}, {"name": "description", "type": "string"},
              {"name": "hook", "type": "address"}],
   "outputs": [{"name": "", "type": "uint256"}]},
  {"name": "fund", "type": "function", "stateMutability": "nonpayable",
   "inputs": [{"name": "jobId", "type": "uint256"}, {"name": "expectedBudget", "type": "uint256"},
              {"name": "optParams", "type": "bytes"}], "outputs": []},
]
jobs = w3.eth.contract(address=ESCROW, abi=ABI)

def send(fn):
    tx = fn.build_transaction({"from": me.address, "nonce": w3.eth.get_transaction_count(me.address)})
    signed = me.sign_transaction(tx)
    return w3.eth.wait_for_transaction_receipt(w3.eth.send_raw_transaction(signed.raw_transaction))

deadline = int(time.time()) + 24 * 3600
send(jobs.functions.createJob("0xProvider", me.address, deadline, "Summarise 10 documents",
                              "0x0000000000000000000000000000000000000000"))

Budget, submit and settle follow the same pattern with setBudget, submit, complete, reject and claimRefund. Approve the token for the escrow before fund.

# Any language: the escrows are plain contracts. With Foundry's cast:
cast send 0x4664d58FAFFb6ab1cf36717c70058a323E2A98f9 \
  "createJob(address,address,uint256,string,address)" \
  0xProvider $(cast wallet address) $(( $(date +%s) + 86400 )) "Summarise 10 documents" \
  0x0000000000000000000000000000000000000000 \
  --rpc-url https://mainnet.base.org --account my-wallet

cast call 0x4664d58FAFFb6ab1cf36717c70058a323E2A98f9 "jobCounter()(uint256)" --rpc-url https://mainnet.base.org

• ARL token · 0xde91E6f39D50bBd875f831dcc1134A3D7f3aaDb4
• Jobs escrow, paid in ARL · 0x4664d58FAFFb6ab1cf36717c70058a323E2A98f9
• Jobs escrow, paid in USDC · 0xc833140D2eE8607fd41662cffFAc557f3D535bE6
• Compute payment · 0x1bFE932896fdd32175836a7364dcaf53d49EE464

Source, tests and the full specification: github.com/armanalabsai/arlcoin.io. Questions or an integration in mind: [email protected].