@mantle-agent/custody
v0.1.6
Published
Turnkey custody for Mantle Agent Accounts: owner sub-orgs, agent wallets, delegated-access session signing policies and read-back verification. Browser-safe entry at /owner.
Readme
@mantle-agent/custody
Turnkey custody for Mantle Agent Accounts (Embedded Wallets model):
- one sub-organization per owner, the owner (passkey) as sole root; email/SMS auth and recovery disabled;
- one wallet per agent:
m/44'/60'/0'/0/0is the agent EOA (root key),/1the session key; - the platform joins each sub-org as a non-root delegated-access user, added from the owner's own session;
- a session signing policy that only lets the platform sign Calibur
SignedBatchedCalls for that account and chain, with that session key, executable only by the platform relayer, until the session expires.
Server side (@mantle-agent/custody): turnkeyClient, createOwnerSubOrg, verifyCustody, readAgentWallet,
verifySessionPolicy, verifyOwnerStamp, sessionSigner, platformSelfRemove.
Browser side (@mantle-agent/custody/owner, no Node-only dependencies): addPlatformDelegate,
createAgentWallet, grantSessionSigning, renewSessionSigning, removePlatformDelegate, rootSigner,
sessionSigningPolicy.
Notes from production use: Turnkey matches signWith case-sensitively (signers checksum it), the passkey stamp
header is X-Stamp-Webauthn, and a freshly created sub-org can take a few seconds to become visible.
