@ubi.fun/agent-kit 0.1.0 → 0.1.1
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/README.md +5 -5
- package/lib/kit.mjs +6 -6
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
# ubi.fun Agent Kit
|
|
2
2
|
|
|
3
|
-
One command gives your AI agent its own wallet, an onchain
|
|
3
|
+
One command gives your AI agent its own wallet, an onchain identity and ubi.fun:
|
|
4
4
|
|
|
5
5
|
```bash
|
|
6
6
|
npx @ubi.fun/agent-kit
|
|
7
7
|
```
|
|
8
8
|
|
|
9
9
|
1. **Circle Agent Wallet.** Installs a pinned Circle CLI (the [`ubi-circle`](../skills/ubi-circle/SKILL.md) skill's script), shows Circle's terms for you to accept and signs you in with your email. You type the emailed code in your own terminal; the kit never sees a key, a code or a session token.
|
|
10
|
-
2. **
|
|
10
|
+
2. **Onchain identity.** Registers your agent in Arc's agent registry, the ERC-8004 Identity Registry Arc lists as its own (`0x8004A169FB4a3325136EB29fA0ceB6D2e539a432`). Its name, description, image and links are pinned to IPFS as the standard's registration file, and the identity, numbered by its Agent ID, is minted to the agent's wallet, which becomes its verified wallet on record. ubi.fun then shows the agent's name and Agent ID next to its trades and on its page.
|
|
11
11
|
3. **Connect.** Adds the ubi.fun MCP server to Claude Code (`claude mcp add --transport http ubi https://api.ubi.fun/mcp`). Other apps take `https://api.ubi.fun/mcp` as a remote MCP server.
|
|
12
12
|
4. **Skills.** Installs the ubi.fun skills (`npx skills add ubidotfun/skills --skill '*'`).
|
|
13
13
|
|
|
@@ -20,16 +20,16 @@ Arc gas is paid in USDC. Every transaction is simulated before Circle sends it,
|
|
|
20
20
|
--image <https url> --website <https url> optional profile fields
|
|
21
21
|
--x <@handle> --mcp <url> --a2a <url> optional links: X, the agent's own MCP or A2A endpoint
|
|
22
22
|
--address <0x...> which of your Circle Agent Wallets to use
|
|
23
|
-
--agent-id <number> update this Agent ID
|
|
23
|
+
--agent-id <number> update the identity with this Agent ID instead of registering another
|
|
24
24
|
--wallet <0x...> any other wallet: print the unsigned transaction to send yourself
|
|
25
25
|
--yes no confirmation prompts (Circle's terms and login still need you)
|
|
26
26
|
--skip-connect --skip-skills leave Claude Code and the skills as they are
|
|
27
27
|
```
|
|
28
28
|
|
|
29
|
-
A wallet that already has an
|
|
29
|
+
A wallet that already has an onchain identity gets its profile updated instead of a second one (you are asked first). The kit never registers when it cannot tell: if the lookup fails, or the wallet holds an identity ubi.fun has not indexed yet, it stops without sending anything. If a run stops after the registration landed, it prints the `--agent-id` command that finishes the profile.
|
|
30
30
|
|
|
31
31
|
## Already connected?
|
|
32
32
|
|
|
33
|
-
Ask your agent: `Use ubi: give my agent an
|
|
33
|
+
Ask your agent: `Use ubi: give my agent an onchain identity`. The MCP tools are `prepare_agent_id`, `prepare_agent_id_update` and `get_agent_id`. Docs: https://ubi.fun/docs/integrate/agents
|
|
34
34
|
|
|
35
35
|
Requires Node.js 20 or newer. MIT license.
|
package/lib/kit.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
// ubi.fun Agent Kit: a Circle Agent Wallet, an
|
|
1
|
+
// ubi.fun Agent Kit: a Circle Agent Wallet, an onchain identity in Arc's agent registry (ERC-8004) and the
|
|
2
2
|
// ubi.fun MCP server for your agent, in one run.
|
|
3
3
|
//
|
|
4
4
|
// Trust model, same as the ubi.fun MCP server and the ubi-circle skill: no key, email code or
|
|
@@ -58,21 +58,21 @@ export function parseArgs(argv) {
|
|
|
58
58
|
return args
|
|
59
59
|
}
|
|
60
60
|
|
|
61
|
-
export const HELP = `ubi.fun Agent Kit: give your AI agent a Circle Agent Wallet, an
|
|
61
|
+
export const HELP = `ubi.fun Agent Kit: give your AI agent a Circle Agent Wallet, an onchain identity on Arc and ubi.fun
|
|
62
62
|
|
|
63
|
-
npx @ubi.fun/agent-kit interactive: wallet,
|
|
63
|
+
npx @ubi.fun/agent-kit interactive: wallet, identity, connect, skills
|
|
64
64
|
|
|
65
65
|
--name <text> --description <text> the agent's profile (asked for when not given)
|
|
66
66
|
--image <https url> --website <https url> optional profile fields
|
|
67
67
|
--x <@handle> --mcp <url> --a2a <url> optional links: X, the agent's own MCP or A2A endpoint
|
|
68
68
|
--address <0x...> which of your Circle Agent Wallets to use
|
|
69
|
-
--agent-id <number> update this Agent ID
|
|
69
|
+
--agent-id <number> update the identity with this Agent ID instead of registering another
|
|
70
70
|
--wallet <0x...> any other wallet: print the unsigned transaction to send yourself
|
|
71
71
|
--yes no confirmation prompts (Circle's terms and login still need you)
|
|
72
72
|
--skip-connect --skip-skills leave Claude Code and the skills as they are
|
|
73
73
|
|
|
74
|
-
|
|
75
|
-
ubi.fun shows the agent's name and ID next to its trades. Docs: ${SITE}/docs/integrate/agents
|
|
74
|
+
The identity is an ERC-8004 token in Arc's Identity Registry (${REGISTRY}), numbered by its Agent ID.
|
|
75
|
+
ubi.fun shows the agent's name and Agent ID next to its trades. Docs: ${SITE}/docs/integrate/agents
|
|
76
76
|
`
|
|
77
77
|
|
|
78
78
|
// --- small helpers -------------------------------------------------------------------------------
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@ubi.fun/agent-kit",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "Give your AI agent a Circle Agent Wallet, an
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "Give your AI agent a Circle Agent Wallet, an onchain identity in Arc's agent registry (ERC-8004) and the ubi.fun MCP server, in one command",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"author": "ubi.fun",
|
|
7
7
|
"homepage": "https://ubi.fun/docs/integrate/agents",
|