(Developers)

Build on palmfi.

Everything is onchain on Arc testnet and every vault reports through one Hub, so you can watch the whole network from a single address.

Contracts

Arc testnet · chain 5042002

Hub
0x7597…e31f
VaultFactory
0xf135…B9ca
OrbitalHook
0x4103…2888
OrbitalRouter
0x331E…7773
PoolManager
0x1d70…f929
USDC
0x3600…0000
Quick start

Resolve a name

import { createPublicClient, http, parseAbi } from "viem";

const client = createPublicClient({ transport: http("https://rpc.testnet.arc.network") });
const hub = "0x7597a94370cBA54DFa94271a02cB8E83c95Ee31f";

const abi = parseAbi([
  "function resolve(string) view returns (address)",
  "function statusOf(address) view returns (uint8)",
]);

const vault = await client.readContract({ address: hub, abi, functionName: "resolve", args: ["northwind"] });
const status = await client.readContract({ address: hub, abi, functionName: "statusOf", args: [vault] });
Hub events

One address to watch

VaultRegistered(vault, name, token)A vault was created
RequestQueued(vault, requestId, requestHash, kind, wallet, amount, destination, reasonCodes)A payment above the budget was queued; the Sentinel's log trigger
RequestUpdated(vault, requestId, state, executableAt, score, reasonCodes)Scored, executed, vetoed, expired, flagged or cancelled
Voted(vault, requestId, voter, yes, yesVotes, noVotes)A wallet voted on a request
Outflow(vault, wallet, destination, amount, viaPool)Money left a vault
ConfigChange(vault, changeId, kind, data, yesVotes, eta)A settings change was proposed or voted
Frozen(vault, by, reasonCodes) / Unfrozen(vault)Freeze state changed
Flagged(vault, requestId, reasonCodes, destination)The Sentinel flagged a request
Blocked(account, sourceVault, until)An address joined the shared blocklist
Heartbeat(timestamp, nonce)The Reconciler's liveness signal
Reason codes

Why the Sentinel scored what it did

0UNUSUAL_AMOUNTAmount is far above this wallet's / Vault's usual outflows
1NEW_DESTINATIONNever paid before and not a known destination
2OFF_HOURSOutside the Vault's business hours
3VELOCITYUnusually many outflows in the last hour / day
4CONFIG_CHANGE_PENDINGA wallet add is pending (possible Sybil attempt)
5NEW_WALLETThe requesting wallet was added less than 7 days ago
6BLOCKLISTED_DESTDestination is on the network Blocklist
7DELEGATION_CHANGEDA wallet's EIP-7702 delegation points at an unapproved target
8RESERVE_MISMATCHUSDC reserves don't cover the Protected token supply
9OVER_HARD_CAPAbove the Hard cap: at least CapDelay unless a majority fast-tracks
10CRE_SILENTNot scored yet: MaxDelay applies until the Sentinel reports
Settings changes

Kinds and timelocks

1Add wallet2d 0h
2Remove walletnow
3Raise Instant budget2d 0h
4Change Hard cap / delays2d 0h
5Add destination2d 0h
6Add approved delegate2d 0h
7Change Recovery vault7d 0h
8Change Recovery key7d 0h
9Unfreezenow
10Migrate to Recovery vaultnow
Scoring parameters

This network

Doubling step
2.5 bits
Flag threshold
18 bits