@agentlayer.tech/wallet 0.1.10 → 0.1.12
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +30 -0
- package/README.md +50 -57
- package/agent-wallet/README.md +42 -0
- package/agent-wallet/agent_wallet/config.py +11 -1
- package/agent-wallet/agent_wallet/openclaw_adapter.py +74 -9
- package/agent-wallet/agent_wallet/providers/jupiter.py +171 -2
- package/agent-wallet/pyproject.toml +2 -1
- package/agent-wallet/scripts/bootstrap_openclaw_evm.py +291 -0
- package/agent-wallet/scripts/install_agent_wallet.py +1 -0
- package/agent-wallet/scripts/install_openclaw_local_config.py +9 -0
- package/agent-wallet/scripts/manage_openclaw_evm_wallet.py +343 -0
- package/agent-wallet/scripts/setup_evm_wallet.sh +151 -0
- package/bin/openclaw-agent-wallet.mjs +229 -5
- package/hermes/plugins/agent_wallet/README.md +54 -0
- package/hermes/plugins/agent_wallet/__init__.py +55 -0
- package/hermes/plugins/agent_wallet/plugin.yaml +9 -0
- package/hermes/plugins/agent_wallet/schemas.py +206 -0
- package/hermes/plugins/agent_wallet/tools.py +533 -0
- package/package.json +4 -1
|
@@ -0,0 +1,206 @@
|
|
|
1
|
+
"""Tool schemas exposed to Hermes Agent."""
|
|
2
|
+
|
|
3
|
+
AGENT_WALLET_TOOLS = {
|
|
4
|
+
"name": "agent_wallet_tools",
|
|
5
|
+
"description": (
|
|
6
|
+
"List AgentLayer wallet capabilities available through the Hermes bridge. "
|
|
7
|
+
"Use this before agent_wallet_invoke when you need the exact underlying "
|
|
8
|
+
"wallet tool names, JSON schemas, or safety levels. This is read-only and "
|
|
9
|
+
"does not create, unlock, or modify wallets."
|
|
10
|
+
),
|
|
11
|
+
"parameters": {
|
|
12
|
+
"type": "object",
|
|
13
|
+
"properties": {
|
|
14
|
+
"backend": {
|
|
15
|
+
"type": "string",
|
|
16
|
+
"enum": ["all", "solana_local", "wdk_btc_local", "wdk_evm_local"],
|
|
17
|
+
"description": "Optional backend filter. Defaults to all.",
|
|
18
|
+
},
|
|
19
|
+
},
|
|
20
|
+
"additionalProperties": False,
|
|
21
|
+
},
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
AGENT_WALLET_INVOKE = {
|
|
25
|
+
"name": "agent_wallet_invoke",
|
|
26
|
+
"description": (
|
|
27
|
+
"Invoke one existing AgentLayer/OpenClaw wallet tool through the local "
|
|
28
|
+
"Python wallet backend. Prefer read-only tools and preview modes first. "
|
|
29
|
+
"Execute modes require an approval_token from agent_wallet_approve bound "
|
|
30
|
+
"to the exact previewed operation after explicit user confirmation."
|
|
31
|
+
),
|
|
32
|
+
"parameters": {
|
|
33
|
+
"type": "object",
|
|
34
|
+
"properties": {
|
|
35
|
+
"tool_name": {
|
|
36
|
+
"type": "string",
|
|
37
|
+
"description": "Underlying wallet tool name, for example get_wallet_address or transfer_sol.",
|
|
38
|
+
},
|
|
39
|
+
"arguments": {
|
|
40
|
+
"type": "object",
|
|
41
|
+
"description": "JSON arguments for the underlying wallet tool.",
|
|
42
|
+
"additionalProperties": True,
|
|
43
|
+
},
|
|
44
|
+
"backend": {
|
|
45
|
+
"type": "string",
|
|
46
|
+
"enum": ["solana_local", "wdk_btc_local", "wdk_evm_local"],
|
|
47
|
+
"description": "Optional backend override for this invocation.",
|
|
48
|
+
},
|
|
49
|
+
"network": {
|
|
50
|
+
"type": "string",
|
|
51
|
+
"description": "Optional network override, such as devnet, mainnet, bitcoin, ethereum, or base.",
|
|
52
|
+
},
|
|
53
|
+
"user_id": {
|
|
54
|
+
"type": "string",
|
|
55
|
+
"description": "Optional local wallet owner id. Defaults to AGENT_WALLET_USER_ID, USER, or hermes-local-user.",
|
|
56
|
+
},
|
|
57
|
+
"config": {
|
|
58
|
+
"type": "object",
|
|
59
|
+
"description": (
|
|
60
|
+
"Optional non-secret wallet config overrides. Do not include privateKey, "
|
|
61
|
+
"masterKey, or approvalSecret."
|
|
62
|
+
),
|
|
63
|
+
"additionalProperties": True,
|
|
64
|
+
},
|
|
65
|
+
},
|
|
66
|
+
"required": ["tool_name"],
|
|
67
|
+
"additionalProperties": False,
|
|
68
|
+
},
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
AGENT_WALLET_APPROVE = {
|
|
72
|
+
"name": "agent_wallet_approve",
|
|
73
|
+
"description": (
|
|
74
|
+
"Issue a short-lived AgentLayer/OpenClaw approval_token for one exact "
|
|
75
|
+
"wallet execute operation after the user explicitly confirms the previewed "
|
|
76
|
+
"confirmation_summary. Use only after agent_wallet_invoke preview/prepare "
|
|
77
|
+
"returns the exact confirmation_summary. Mainnet approvals require "
|
|
78
|
+
"mainnet_confirmed=true."
|
|
79
|
+
),
|
|
80
|
+
"parameters": {
|
|
81
|
+
"type": "object",
|
|
82
|
+
"properties": {
|
|
83
|
+
"tool_name": {
|
|
84
|
+
"type": "string",
|
|
85
|
+
"description": "Underlying wallet tool name that will be executed.",
|
|
86
|
+
},
|
|
87
|
+
"confirmation_summary": {
|
|
88
|
+
"type": "object",
|
|
89
|
+
"description": (
|
|
90
|
+
"Exact confirmation_summary from the preview or prepare result. "
|
|
91
|
+
"Do not edit or summarize it."
|
|
92
|
+
),
|
|
93
|
+
"additionalProperties": True,
|
|
94
|
+
},
|
|
95
|
+
"user_confirmed": {
|
|
96
|
+
"type": "boolean",
|
|
97
|
+
"description": "Must be true only after the user explicitly approves this exact operation.",
|
|
98
|
+
},
|
|
99
|
+
"mainnet_confirmed": {
|
|
100
|
+
"type": "boolean",
|
|
101
|
+
"description": "Must be true for mainnet execute operations after explicit mainnet confirmation.",
|
|
102
|
+
},
|
|
103
|
+
"ttl_seconds": {
|
|
104
|
+
"type": "integer",
|
|
105
|
+
"minimum": 1,
|
|
106
|
+
"maximum": 3600,
|
|
107
|
+
"description": "Optional approval token lifetime in seconds.",
|
|
108
|
+
},
|
|
109
|
+
"backend": {
|
|
110
|
+
"type": "string",
|
|
111
|
+
"enum": ["solana_local", "wdk_btc_local", "wdk_evm_local"],
|
|
112
|
+
"description": "Optional backend override matching the planned execute invocation.",
|
|
113
|
+
},
|
|
114
|
+
"network": {
|
|
115
|
+
"type": "string",
|
|
116
|
+
"description": "Optional network override matching the planned execute invocation.",
|
|
117
|
+
},
|
|
118
|
+
"user_id": {
|
|
119
|
+
"type": "string",
|
|
120
|
+
"description": "Optional local wallet owner id. Defaults to AGENT_WALLET_USER_ID, USER, or hermes-local-user.",
|
|
121
|
+
},
|
|
122
|
+
"config": {
|
|
123
|
+
"type": "object",
|
|
124
|
+
"description": (
|
|
125
|
+
"Optional non-secret wallet config overrides matching the planned execute invocation. "
|
|
126
|
+
"Do not include privateKey, masterKey, or approvalSecret."
|
|
127
|
+
),
|
|
128
|
+
"additionalProperties": True,
|
|
129
|
+
},
|
|
130
|
+
},
|
|
131
|
+
"required": ["tool_name", "confirmation_summary", "user_confirmed"],
|
|
132
|
+
"additionalProperties": False,
|
|
133
|
+
},
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
AGENT_WALLET_EVM_STATUS = {
|
|
137
|
+
"name": "agent_wallet_evm_status",
|
|
138
|
+
"description": (
|
|
139
|
+
"Inspect the local EVM wallet runtime used by AgentLayer/OpenClaw. "
|
|
140
|
+
"Returns wdk-evm-wallet health, network info, and existing user wallet "
|
|
141
|
+
"bindings without changing wallet state."
|
|
142
|
+
),
|
|
143
|
+
"parameters": {
|
|
144
|
+
"type": "object",
|
|
145
|
+
"properties": {
|
|
146
|
+
"user_id": {
|
|
147
|
+
"type": "string",
|
|
148
|
+
"description": "Optional local wallet owner id to inspect.",
|
|
149
|
+
},
|
|
150
|
+
"network": {
|
|
151
|
+
"type": "string",
|
|
152
|
+
"description": "Optional EVM network hint, such as ethereum, base, sepolia, or base-sepolia.",
|
|
153
|
+
},
|
|
154
|
+
"service_url": {
|
|
155
|
+
"type": "string",
|
|
156
|
+
"description": "Optional localhost override for the wdk-evm-wallet service.",
|
|
157
|
+
},
|
|
158
|
+
},
|
|
159
|
+
"additionalProperties": False,
|
|
160
|
+
},
|
|
161
|
+
}
|
|
162
|
+
|
|
163
|
+
AGENT_WALLET_EVM_SETUP = {
|
|
164
|
+
"name": "agent_wallet_evm_setup",
|
|
165
|
+
"description": (
|
|
166
|
+
"Create or unlock the local EVM wallet binding used by AgentLayer/OpenClaw "
|
|
167
|
+
"for Hermes. This can auto-start the localhost-only wdk-evm-wallet service, "
|
|
168
|
+
"set up the selected network, and bind the same wallet to the paired EVM network "
|
|
169
|
+
"such as ethereum/base."
|
|
170
|
+
),
|
|
171
|
+
"parameters": {
|
|
172
|
+
"type": "object",
|
|
173
|
+
"properties": {
|
|
174
|
+
"password": {
|
|
175
|
+
"type": "string",
|
|
176
|
+
"description": "Local EVM wallet password used to create or unlock the vault wallet.",
|
|
177
|
+
},
|
|
178
|
+
"user_id": {
|
|
179
|
+
"type": "string",
|
|
180
|
+
"description": "Optional local wallet owner id. Defaults to AGENT_WALLET_USER_ID, USER, or hermes-local-user.",
|
|
181
|
+
},
|
|
182
|
+
"network": {
|
|
183
|
+
"type": "string",
|
|
184
|
+
"description": "Selected EVM network, typically ethereum or base.",
|
|
185
|
+
},
|
|
186
|
+
"label": {
|
|
187
|
+
"type": "string",
|
|
188
|
+
"description": "Optional wallet label used when creating a new local EVM wallet.",
|
|
189
|
+
},
|
|
190
|
+
"service_url": {
|
|
191
|
+
"type": "string",
|
|
192
|
+
"description": "Optional localhost override for the wdk-evm-wallet service.",
|
|
193
|
+
},
|
|
194
|
+
"auto_start_service": {
|
|
195
|
+
"type": "boolean",
|
|
196
|
+
"description": "Whether to auto-start the local wdk-evm-wallet service when it is not healthy. Defaults to true.",
|
|
197
|
+
},
|
|
198
|
+
"bind_network_pair": {
|
|
199
|
+
"type": "boolean",
|
|
200
|
+
"description": "Whether to also bind the paired EVM network such as ethereum/base. Defaults to true.",
|
|
201
|
+
},
|
|
202
|
+
},
|
|
203
|
+
"required": ["password"],
|
|
204
|
+
"additionalProperties": False,
|
|
205
|
+
},
|
|
206
|
+
}
|