Add CAIP: CLI Wallet Protocol (CWP)#397
Merged
bumblefudge merged 2 commits intoChainAgnostic:mainfrom Mar 3, 2026
Merged
Conversation
Proposes a standard for CLI wallet discovery and interaction via executable plugins on PATH, inspired by EIP-6963 and git credential helpers. Discussion: ChainAgnostic#396 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Introduces grant-session, revoke-session, and get-session operations that let a human pre-approve scoped permissions (spending limits, rate limits, contract allowlists) for AI agents to operate without per-operation approval. Adds permission/policy type system, session error codes, security considerations, and rationale. References EIP-7715, EIP-7710, and CAIP-171. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
bumblefudge
reviewed
Mar 2, 2026
|
|
||
| #### `grant-session` | ||
|
|
||
| Creates a scoped permission session for autonomous operation. MUST complete within 120 seconds (requires human approval to authorize the session). |
Collaborator
There was a problem hiding this comment.
is human approval assumed to be interactive? Would it be more precise/explicit to say "MUST timeout if interactive user approval has not authorized the session within 120 seconds"?
bumblefudge
reviewed
Mar 2, 2026
|
|
||
| #### `info` | ||
|
|
||
| Returns provider metadata and capabilities. MUST complete within 3 seconds. |
Collaborator
There was a problem hiding this comment.
Suggested change
| Returns provider metadata and capabilities. MUST complete within 3 seconds. | |
| Returns provider metadata and capabilities, and doubles as [discovery mechanism](#Discovery). MUST complete within 3 seconds. |
Collaborator
|
Hey this great and well-thought out, appreciate all the Considerations. Minor things:
Footnotes
|
bumblefudge
approved these changes
Mar 3, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This CAIP proposes a standard protocol for CLI applications to discover and interact with wallet providers through executable plugins on PATH.
Key concepts:
wallet-<name>executables (e.g.,wallet-walletconnect,wallet-ledger,wallet-cast)info,accounts,sign-message,sign-typed-data,sign-transaction,send-transaction~/.config/wallet/config.jsonfor preferenceswalletCLI discovers providers and delegatesInspired by:
Motivation
CLI blockchain tools (API clients, deployment scripts, AI agents) hardcode specific wallet providers. There's no CLI equivalent of EIP-6963 for pluggable wallet discovery. This creates tight coupling and limits user choice.
Reference Implementations
@anthropic-ai/wallet-cli— discoverswallet-*on PATH, delegates operationswallet-walletconnect— CWP adapter for thewalletconnectCLInansen-cli— useswalletCLI for x402 auto-payment signingDiscussion
#396