(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
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 createdRequestQueued(vault, requestId, requestHash, kind, wallet, amount, destination, reasonCodes)A payment above the budget was queued; the Sentinel's log triggerRequestUpdated(vault, requestId, state, executableAt, score, reasonCodes)Scored, executed, vetoed, expired, flagged or cancelledVoted(vault, requestId, voter, yes, yesVotes, noVotes)A wallet voted on a requestOutflow(vault, wallet, destination, amount, viaPool)Money left a vaultConfigChange(vault, changeId, kind, data, yesVotes, eta)A settings change was proposed or votedFrozen(vault, by, reasonCodes) / Unfrozen(vault)Freeze state changedFlagged(vault, requestId, reasonCodes, destination)The Sentinel flagged a requestBlocked(account, sourceVault, until)An address joined the shared blocklistHeartbeat(timestamp, nonce)The Reconciler's liveness signalReason codes
Why the Sentinel scored what it did
0
UNUSUAL_AMOUNTAmount is far above this wallet's / Vault's usual outflows1
NEW_DESTINATIONNever paid before and not a known destination2
OFF_HOURSOutside the Vault's business hours3
VELOCITYUnusually many outflows in the last hour / day4
CONFIG_CHANGE_PENDINGA wallet add is pending (possible Sybil attempt)5
NEW_WALLETThe requesting wallet was added less than 7 days ago6
BLOCKLISTED_DESTDestination is on the network Blocklist7
DELEGATION_CHANGEDA wallet's EIP-7702 delegation points at an unapproved target8
RESERVE_MISMATCHUSDC reserves don't cover the Protected token supply9
OVER_HARD_CAPAbove the Hard cap: at least CapDelay unless a majority fast-tracks10
CRE_SILENTNot scored yet: MaxDelay applies until the Sentinel reportsSettings 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