@zoralabs/cli 1.0.1 → 1.2.0

package/README.md

@@ -25,26 +25,35 @@ zora explore
 zora get <address-or-name>
 
 # Check price history
-zora price-history <address-or-name>
+zora get price-history <address-or-name>
+
+# View recent trades on a coin
+zora get trades <address-or-name>
+
+# See top holders
+zora get holders <address-or-name>
 ```
 
 ## Commands
 
-All commands support `--json` for machine-readable output. Commands with live data (`explore`, `balance`, `profile`) also support `--live` (interactive, default) and `--static` (snapshot). Use `--refresh <seconds>` to set the auto-refresh interval in `--live` mode.
-
-| Command         | Description                                               | Wallet required |
-| --------------- | --------------------------------------------------------- | --------------- |
-| `setup`         | Guided first-time setup (wallet + API key + deposit info) | —               |
-| `explore`       | Browse top, new, and highest volume coins                 | No              |
-| `get`           | Look up a coin by address or name                         | No              |
-| `price-history` | Display price history for a coin                          | No              |
-| `auth`          | Configure or check API key status                         | No              |
-| `profile`       | View creator or user profiles                             | No              |
-| `buy`           | Buy a coin                                                | Yes             |
-| `sell`          | Sell a coin                                               | Yes             |
-| `balance`       | Show wallet balances (ETH, USDC, ZORA) and coin positions | Yes             |
-| `wallet`        | Show wallet address, export key, or configure wallet      | Yes             |
-| `send`          | Send tokens to another address                            | Yes             |
+All commands support `--json` for machine-readable output. Commands with live data (`explore`, `get`, `balance`, `profile`) also support `--live` (interactive, default) and `--static` (snapshot). Use `--refresh <seconds>` to set the auto-refresh interval in `--live` mode.
+
+| Command             | Description                                               | Wallet required |
+| ------------------- | --------------------------------------------------------- | --------------- |
+| `setup`             | Guided first-time setup (wallet + API key + deposit info) | —               |
+| `explore`           | Browse top, new, and highest volume coins                 | No              |
+| `get`               | Look up a coin by address or name                         | No              |
+| `get price-history` | Display price history for a coin                          | No              |
+| `get trades`        | Show recent buy/sell activity on a coin                   | No              |
+| `get holders`       | Show top holders of a coin                                | No              |
+| `auth`              | Configure or check API key status                         | No              |
+| `agent`             | Create a headless Privy account for an agent              | No              |
+| `profile`           | View creator or user profiles                             | No              |
+| `buy`               | Buy a coin                                                | Yes             |
+| `sell`              | Sell a coin                                               | Yes             |
+| `balance`           | Show wallet balances (ETH, USDC, ZORA) and coin positions | Yes             |
+| `wallet`            | Show wallet address, export key, or configure wallet      | Yes             |
+| `send`              | Send tokens to another address                            | Yes             |
 
 Run `zora --help` or `zora <command> --help` for detailed usage.
 
@@ -63,11 +72,34 @@ The private key is stored locally at `~/.config/zora/wallet.json` with restricte
 
 ### Advanced
 
-To configure wallet or API key individually (without running the full setup flow). All commands work without an API key but may be rate-limited:
+To configure wallet or API key individually (without running the full setup flow). All commands work without an API key but may be rate-limited. An API key also provides more accurate coin valuations in `zora balance` by using the SDK's liquidity-aware pricing:
 
 - `zora wallet configure` — create or import a wallet (`--create`, `--force`)
 - `zora auth configure` — save an API key; `zora auth status` — check current config
 
+## Agents
+
+`zora agent create` stands up a complete Zora agent identity from an EOA, with no human interaction: a headless Privy account (Sign-In-With-Ethereum — no Privy dashboard, email, or OTP), a Zora profile, a smart wallet, a creator coin, and a first post. Every on-chain step is paymaster-sponsored, so the agent needs no ETH, and it authenticates with only the Privy session — never a `zora.co/settings/developer` API key.
+
+```bash
+# Full onboarding: account → profile → smart wallet → creator coin → first post
+zora agent create
+
+# Dry run: create the account, profile, and smart wallet, but simulate the coin + post
+zora agent create --dry-run
+
+# JSON output for automation
+zora agent create --json
+
+# Use a specific key without saving it, and skip steps as needed
+zora agent create --private-key 0x... --skip-post
+
+# Choose the agent's own profile at creation (all optional; otherwise autogenerated)
+zora agent create --username my-agent --bio "gm, I trade memecoins" --avatar ./pfp.png
+```
+
+The output includes the agent's profile handle, its smart wallet, **links to the new profile, creator coin, and first post**, and a **Privy access token** (a session JWT, ~1h) to send as `Authorization: Bearer <token>` for further Zora API calls. The EOA is resolved from `--private-key`, then `ZORA_PRIVATE_KEY`, then the saved CLI wallet (`~/.config/zora/wallet.json`); otherwise a new one is generated and saved — back it up, as it owns the agent. The first post's artwork is a bundled, Zora-themed greeting card (no avatar/username, so it stays appropriate permanently).
+
 ## Documentation
 
 Full documentation is available at [cli.zora.com](https://cli.zora.com/).

package/dist/client-4HW4ZUHD.js

@@ -0,0 +1,166 @@
+#!/usr/bin/env node
+
+// src/messaging/client.ts
+import { homedir, platform } from "os";
+import { join } from "path";
+import { mkdirSync } from "fs";
+import {
+  Client,
+  ConsentState,
+  IdentifierKind,
+  LogLevel,
+  isText
+} from "@xmtp/node-sdk";
+import { ReactionCodec } from "@xmtp/content-type-reaction";
+import { ReadReceiptCodec } from "@xmtp/content-type-read-receipt";
+import { getAddress } from "viem";
+var CONSENT_TO_SDK = {
+  allowed: ConsentState.Allowed,
+  unknown: ConsentState.Unknown,
+  denied: ConsentState.Denied
+};
+var consentFromSdk = (state) => {
+  if (state === ConsentState.Allowed) return "allowed";
+  if (state === ConsentState.Denied) return "denied";
+  return "unknown";
+};
+var toIdentifier = (address) => ({
+  identifier: address.toLowerCase(),
+  identifierKind: IdentifierKind.Ethereum
+});
+var formatContentType = (ct) => `${ct.authorityId}/${ct.typeId}:${ct.versionMajor}.${ct.versionMinor}`;
+var asAddress = (value) => {
+  if (!value) return null;
+  try {
+    return getAddress(value);
+  } catch {
+    return null;
+  }
+};
+var defaultDbPath = (env, inboxId) => {
+  const base = platform() === "win32" ? join(
+    process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"),
+    "zora"
+  ) : join(homedir(), ".config", "zora");
+  const dir = join(base, "xmtp");
+  mkdirSync(dir, { recursive: true });
+  return join(dir, `xmtp-${env}-${inboxId}.db3`);
+};
+var buildXmtpSigner = (spec) => {
+  const getIdentifier = () => toIdentifier(spec.address);
+  if (spec.type === "EOA") {
+    return { type: "EOA", getIdentifier, signMessage: spec.signMessage };
+  }
+  return {
+    type: "SCW",
+    getIdentifier,
+    getChainId: () => BigInt(spec.chainId),
+    signMessage: spec.signMessage
+  };
+};
+var createMessagingClient = async (spec, options = {}) => {
+  const env = options.env ?? "production";
+  const signer = buildXmtpSigner(spec);
+  const clientOptions = {
+    env,
+    appVersion: "zora/cli",
+    codecs: [new ReactionCodec(), new ReadReceiptCodec()],
+    dbEncryptionKey: options.dbEncryptionKey,
+    dbPath: options.dbPath ?? ((inboxId) => defaultDbPath(env, inboxId)),
+    loggingLevel: LogLevel.Off
+  };
+  const client = await Client.create(signer, clientOptions);
+  if (options.registerInstallation) {
+    try {
+      await options.registerInstallation(client.installationId);
+    } catch {
+    }
+  }
+  const address = getAddress(spec.address);
+  const selfInboxId = client.inboxId;
+  const addressMapForDm = async (dm) => {
+    const members = await dm.members();
+    const map = /* @__PURE__ */ new Map();
+    for (const member of members) {
+      const addr = asAddress(member.accountIdentifiers[0]?.identifier);
+      if (addr) map.set(member.inboxId, addr);
+    }
+    return map;
+  };
+  const toMessage = (message, addrByInbox) => ({
+    id: message.id,
+    senderAddress: addrByInbox.get(message.senderInboxId) ?? null,
+    fromSelf: message.senderInboxId === selfInboxId,
+    text: isText(message) ? message.content ?? null : null,
+    contentType: formatContentType(message.contentType),
+    sentAtMs: Number(message.sentAtNs / 1000000n)
+  });
+  const findDm = (peerAddress) => client.conversations.fetchDmByIdentifier(toIdentifier(peerAddress));
+  return {
+    address,
+    async sync(consent) {
+      const states = consent?.map((c) => CONSENT_TO_SDK[c]);
+      await client.conversations.syncAll(states);
+      await client.conversations.sync();
+    },
+    async listDms(consent) {
+      const states = consent?.map((c) => CONSENT_TO_SDK[c]);
+      const dms = client.conversations.listDms({ consentStates: states });
+      return Promise.all(
+        dms.map(async (dm) => {
+          const [addrByInbox, lastMessage] = await Promise.all([
+            addressMapForDm(dm),
+            dm.lastMessage()
+          ]);
+          return {
+            id: dm.id,
+            peerAddress: addrByInbox.get(dm.peerInboxId) ?? null,
+            consent: consentFromSdk(dm.consentState()),
+            profile: null,
+            lastMessage: lastMessage ? toMessage(lastMessage, addrByInbox) : null
+          };
+        })
+      );
+    },
+    async readMessages(peerAddress, limit = 30) {
+      const dm = await findDm(peerAddress);
+      if (!dm) return [];
+      const [addrByInbox, messages] = await Promise.all([
+        addressMapForDm(dm),
+        dm.messages({ limit })
+      ]);
+      return messages.map((m) => toMessage(m, addrByInbox));
+    },
+    async sendText(peerAddress, text, gateNewConversation) {
+      let dm = await findDm(peerAddress);
+      if (!dm) {
+        if (gateNewConversation) await gateNewConversation(peerAddress);
+        dm = await client.conversations.createDmWithIdentifier(
+          toIdentifier(peerAddress)
+        );
+      }
+      const id = await dm.sendText(text);
+      return {
+        id,
+        senderAddress: address,
+        fromSelf: true,
+        text,
+        contentType: "xmtp.org/text:1.0",
+        sentAtMs: Date.now()
+      };
+    },
+    async setConsent(peerAddress, consent) {
+      const dm = await findDm(peerAddress);
+      if (!dm) {
+        throw new Error(`No conversation found with ${peerAddress}`);
+      }
+      await dm.updateConsentState(CONSENT_TO_SDK[consent]);
+    },
+    async close() {
+    }
+  };
+};
+export {
+  buildXmtpSigner,
+  createMessagingClient
+};