@stage-labs/metro 0.1.0-beta.247 → 0.1.0-beta.249

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.247",
+  "version": "0.1.0-beta.249",
   "description": "The metro command line: run your agent on this machine, relaying its chat channels and connectors to Claude Code.",
   "license": "MIT",
   "repository": {

package/runtime/marketplace/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "metro",
-  "version": "0.1.0-beta.247",
+  "version": "0.1.0-beta.249",
   "description": "Metro for Claude Code, installed by the metro daemon on this machine: every connector the agent holds as its own MCP server relayed through the daemon, the orchestrator-only guard on the main thread, and the standing rules loaded at each session start. No vendor credential ever sits in a config file.",
   "author": {
     "name": "Bonustrack",

package/runtime/marketplace/plugin/STAGE.md

@@ -1,6 +1,6 @@
 ---
 name: stage
-description: How to use Stage channels (XMTP groups, https://stage.box) through metro. Create a channel, rename it, add or remove members, set labels and assignees, read its info, and send, reply, react, unreact, delete and read messages, and post frames (interactive ChatKit widget views). Works only when this agent has an XMTP account in metro.
+description: How to use Stage channels (XMTP groups, https://stage.box) through metro. Create a channel, rename it, add or remove members, set labels and assignees, read its info, and send, reply, react, unreact, delete and read messages, and post frames (interactive ChatKit widget views) and wallet cards (payment and signature requests, receipts). Works only when this agent has an XMTP account in metro.
 ---
 
 Stage (https://stage.box) is a messenger built on XMTP. A Stage channel is an XMTP group. You use it with the metro tools below (`mcp__metro__<name>`).
@@ -18,9 +18,10 @@ Stage (https://stage.box) is a messenger built on XMTP. A Stage channel is an XM
 - Direct chat: `dm {"address": "0x…"}` opens a 1:1 chat and returns its line.
 - With several XMTP accounts, add `"account": "<id>"` to `create_group` and `dm`.
 
-**Labels and assignees.** They live in the channel's metadata, and Stage shows them on the channel.
+**Labels, assignees and category.** They live in the channel's metadata, and Stage shows them on the channel.
 - Labels: `set_channel_metadata {"line": "…", "metadata": {"labels": ["🚧 In progress", "Metro"]}}`. At most 16 labels of 24 characters each.
 - Assignees: `set_channel_metadata {"line": "…", "metadata": {"assigned": ["0x…"]}}`. Only 0x addresses of current members.
+- Category: `set_channel_metadata {"line": "…", "metadata": {"category": "Clients"}}`. One per channel, 24 characters at most; `""` clears it. `group_info` returns it as `category`.
 - Each key you send replaces that whole list. Keys you leave out stay as they are. To add one label or one assignee, read `group_info` first and send the old list plus the new one. `[]` clears a list. Read `group_info` again to check it saved.
 
 **Task status labels.** When a channel is a task, keep exactly one of these status labels, plus any project labels:
@@ -73,3 +74,17 @@ Move it from Backlog or To-do to In progress, then In review, then Done. Use Blo
     ]}}
   }}}
   ```
+
+**Wallet cards.** The payment and signature cards Stage's own Request payment and Request signature send. Sending one moves nothing and signs nothing: the person taps Pay or Sign and confirms in Stage. Send one only when you were asked to.
+- Send: `send {"line": "…", "wallet": {"type": "<type>", "content": {…}}}`. With `text` or a `frame` as well, the card goes last, and the `message_id` you get back is the card's.
+- Payment request, `walletSendCalls`, a card with a Pay button. Stage pays a request with one call; a Stage wallet pays on Base only.
+  ```json
+  {"type": "walletSendCalls", "content": {"version": "1.0", "chainId": "0x2105", "from": "0x<your address>", "calls": [
+    {"to": "0x<who gets paid>", "value": "0x38d7ea4c68000", "metadata": {"description": "Dinner", "transactionType": "transfer",
+      "currency": "ETH", "amount": 0.001, "decimals": 18, "toAddress": "0x<who gets paid>"}}
+  ]}}
+  ```
+  `chainId` is a hex string (`0x2105` is Base) and `value` is in wei, hex. For a token, `to` is the token contract, `data` its `transfer(address,uint256)` call data, `value` is left out, and `metadata` has `currency`, `amount` and `toAddress` (who gets paid).
+- Receipt, `transactionReference`: `{"networkId": 8453, "reference": "0x<tx hash>", "metadata": {"currency": "USDC", "amount": 5}}`. Stage shows "Payment sent · 5 USDC" (or "Transaction sent" without an amount) and a link to the explorer. Only post a real transaction hash.
+- Signature request, `signatureRequest`, a card with a Sign button: `{"id": "<any id>", "kind": "personal", "message": "The text to sign", "description": "Why"}`, or `"kind": "eip712"` with `"eip712": {"domain", "types", "primaryType", "message"}` instead of `message`.
+- Signature, `signatureReference`: `{"requestId": "<message_id of the request>", "signature": "0x…", "signer": "0x…"}`. Stage shows it as Signed.

package/runtime/node_modules/@metro-labs/daemon/src/claude/setup.ts

@@ -166,6 +166,7 @@ const PRIOR_STAGE: ReadonlySet<string> = new Set([
   'e3b8f9bbdb205311bc643aaf91d9d903a91204fd5b55ca949b85cdfa6fd00136',
   '08a30f5cd5cf8013ab70c1fa9e1109018c0337552296a8efe5c0cf543b284991',
   'f87e9494ea6151d140b742c1b88b4f435ae653559be641fddc2160cd24dd4e1b',
+  'cb4307b016855c1a09d48bc8b3924a3080bd78b205963df3d6f20401d0486df9',
 ]);
 const PRIOR_MEMORY: ReadonlySet<string> = new Set(['08795399635c8cdec2b50cb4e336f89ae880f3997ae52560ef647a9cdc8f1b08']);
 

package/runtime/node_modules/@metro-labs/daemon/src/mcp/call-tools.ts

@@ -60,16 +60,20 @@ function assertDelivered(
     );
 }
 
-const frameOf = (m: MessageArgs): Record<string, unknown> =>
-  m.a.frame === undefined ? {} : { frame: m.a.frame };
+const STAGE_PARTS = ['frame', 'wallet'] as const;
+
+const stagePartsIn = (m: MessageArgs): string[] => STAGE_PARTS.filter((key) => m.a[key] !== undefined);
+
+const stagePartArgs = (m: MessageArgs): Record<string, unknown> =>
+  Object.fromEntries(stagePartsIn(m).map((key) => [key, m.a[key]]));
 
 const sentLabels = (m: MessageArgs, text: string | undefined): string[] => [
   ...(text ? ['text'] : []),
-  ...(m.a.frame === undefined ? [] : ['frame']),
+  ...stagePartsIn(m),
 ];
 
 function nativeBody(m: MessageArgs, text: string | undefined, replyTo: string | undefined): Record<string, unknown> {
-  const body: Record<string, unknown> = { line: m.line, ...frameOf(m) };
+  const body: Record<string, unknown> = { line: m.line, ...stagePartArgs(m) };
   if (text) body.text = text;
   if (text && replyTo) body.replyTo = replyTo;
   return body;
@@ -101,7 +105,7 @@ async function sendForwarded(
   atts: ResolvedAttachment[],
 ): Promise<Sent> {
   const { line, ctx, station } = m;
-  const args: Record<string, unknown> = { line, ...frameOf(m) };
+  const args: Record<string, unknown> = { line, ...stagePartArgs(m) };
   if (text) args.text = text;
   if (typeof m.a.subject === 'string' && m.a.subject.trim() !== '') args.subject = m.a.subject;
   if (replyTo) args.replyTo = replyTo;
@@ -123,12 +127,13 @@ const unsupported = (station: Station, atts: CanonicalAttachment[]): string =>
     .map((a) => kindOf(a.mime ?? '', a.path ?? a.url ?? a.name ?? ''))
     .join(', ')}); send a link in \`text\` instead`;
 
-const NOTHING_TO_SEND = 'send requires `text`, `attachments` or `frame`';
+const NOTHING_TO_SEND = 'send requires `text`, `attachments`, `frame` or `wallet`';
 
 function refusal(m: MessageArgs, text: string | undefined, requested: CanonicalAttachment[]): string | undefined {
-  if (!text && !requested.length && m.a.frame === undefined) return NOTHING_TO_SEND;
-  if (m.a.frame !== undefined && m.station.sendsFrames !== true)
-    return `${m.station.name} cannot send a frame; frames are Stage (XMTP) only`;
+  const stageOnly = stagePartsIn(m);
+  if (!text && !requested.length && !stageOnly.length) return NOTHING_TO_SEND;
+  if (stageOnly.length && m.station.sendsFrames !== true)
+    return `${m.station.name} cannot send \`${stageOnly.join('` or `')}\`; that is Stage (XMTP) only`;
   if (requested.length && m.station.attachmentMode === 'none') return unsupported(m.station, requested);
   return undefined;
 }

package/runtime/node_modules/@metro-labs/daemon/src/mcp/permission-prompt.ts

@@ -45,7 +45,7 @@ function argText(value: unknown): string | undefined {
 
 function fieldText(key: string, value: unknown): string | undefined {
   if (key === 'attachments' && Array.isArray(value)) return `${String(value.length)} file(s)`;
-  return key === 'frame' ? argText(value) : valueText(value);
+  return key === 'frame' || key === 'wallet' ? argText(value) : valueText(value);
 }
 
 function metroLines(tool: string, input: Record<string, unknown>): string[] {

package/runtime/node_modules/@metro-labs/daemon/src/mcp/tool-schemas.ts

@@ -34,7 +34,7 @@ export const COMMON_TOOLS: ToolDef[] = [
     group: 'write',
     description:
       'Send a message (and/or media) to a Metro conversation. Args: line, text?, reply_to?, ' +
-      'subject?, attachments?, frame?. The station is derived from the line. Outlook and Gmail: send to ' +
+      'subject?, attachments?, frame?, wallet?. The station is derived from the line. Outlook and Gmail: send to ' +
       'metro://<outlook|gmail>/<account>/<email address> to start a new email (subject defaults to the ' +
       'first line of text); the result names the new thread line. Each attachment names EXACTLY ONE ' +
       'source, and the choice matters: `upload` (an `upload_id` from `create_upload`, the ' +
@@ -42,8 +42,8 @@ export const COMMON_TOOLS: ToolDef[] = [
       '`data` (base64 inline -- TINY FILES ONLY, a few KB, because the base64 has to be ' +
       'written out verbatim in the call and longer than that it corrupts); `url` (the daemon ' +
       'fetches it, so the file must already be public); `path` (resolved on the DAEMON host, ' +
-      'which is not your machine). Stage (XMTP) only: `frame` posts an interactive view. At least one ' +
-      'of text/attachments/frame is required. ' +
+      'which is not your machine). Stage (XMTP) only: `frame` posts an interactive view, `wallet` a payment ' +
+      'or signature card. At least one of text/attachments/frame/wallet is required. ' +
       'The success line names each attachment the station actually delivered; a station that ' +
       'cannot carry a file errors instead of reporting success.',
     inputSchema: {
@@ -99,6 +99,23 @@ export const COMMON_TOOLS: ToolDef[] = [
             description: { type: 'string', description: 'Card description in the chat (1000 characters at most).' },
           },
         },
+        wallet: {
+          type: 'object',
+          description:
+            'Stage (XMTP) only: a wallet card. `type` walletSendCalls is a payment request with a Pay button, ' +
+            'transactionReference a payment receipt with an explorer link, signatureRequest a Sign button, ' +
+            'signatureReference a signed proof. `content` is that type\'s JSON as Stage reads it; the stage skill ' +
+            'has an example of each. Sending it moves nothing: the person taps Pay or Sign and confirms in Stage. ' +
+            "It is sent after the text and any frame, and the message_id returned is the card's.",
+          properties: {
+            type: {
+              type: 'string',
+              enum: ['walletSendCalls', 'transactionReference', 'signatureRequest', 'signatureReference'],
+            },
+            content: { type: 'object', description: 'The JSON of that content type.', additionalProperties: true },
+          },
+          required: ['type', 'content'],
+        },
       },
       required: ['line'],
     },

package/runtime/node_modules/@metro-labs/xmtp/src/actions-meta.ts

@@ -105,12 +105,14 @@ async function applyChannelMeta(
 
 function metaFields(merged: Record<string, unknown>): {
   labels: string[];
+  category: string | undefined;
   github: string | undefined;
   preview: string | undefined;
   assigned: unknown;
 } {
   return {
     labels: Array.isArray(merged.labels) ? (merged.labels as string[]) : [],
+    category: typeof merged.category === 'string' ? merged.category : undefined,
     github: typeof merged.github === 'string' ? merged.github : undefined,
     preview: typeof merged.preview === 'string' ? merged.preview : undefined,
     assigned: Object.hasOwn(merged, 'assigned') ? merged.assigned : [],

package/runtime/node_modules/@metro-labs/xmtp/src/actions.ts

@@ -9,11 +9,13 @@ import {
   AttachmentCodec,
   type Attachment,
 } from '@xmtp/content-type-remote-attachment';
+import type { EncodedContent } from '@xmtp/content-type-primitives';
 import { convOf, type Account } from './accounts.js';
 import { resolveMsgId } from './wire.js';
 import { emitOutbound } from './emit.js';
 import { CallSignalCodec, FrameCodec, PollCodec, buildPollContent, encodeDeleteMessage } from './codecs.js';
 import { buildFrameContent } from './frames.js';
+import { buildWalletContent } from './wallet.js';
 import { callLeftovers } from './call-leftovers.js';
 import { convHandlers } from './actions-conv.js';
 import { messagingAliases } from '@metro-labs/core/stations/messaging-normalize';
@@ -30,19 +32,27 @@ const noConv = (line: string): TrainError =>
 const badArgs = (message: string): TrainError =>
   new TrainError('INVALID_ARGS', message);
 
+function framePart(raw: unknown): { encoded: EncodedContent; summary: string } {
+  const built = buildFrameContent(raw);
+  return { encoded: new FrameCodec().encode(built.frame), summary: `Frame: ${built.title}` };
+}
+
 async function send(id: string, args: Args): Promise<void> {
   const { line, text } = args as { line: string; text: string };
-  const built = args.frame === undefined ? undefined : buildFrameContent(args.frame);
+  const parts = [
+    ...(args.frame === undefined ? [] : [framePart(args.frame)]),
+    ...(args.wallet === undefined ? [] : [buildWalletContent(args.wallet)]),
+  ];
   const { acct, conv } = await convOf(line);
   if (!conv) throw noConv(line);
   let messageId: string | undefined;
-  if (text || !built) {
+  if (text || parts.length === 0) {
     messageId = await conv.sendText(text);
     emitOutbound(acct.cfg.id, line, messageId, text);
   }
-  if (built) {
-    messageId = await conv.send(new FrameCodec().encode(built.frame));
-    emitOutbound(acct.cfg.id, line, messageId, `Frame: ${built.title}`);
+  for (const part of parts) {
+    messageId = await conv.send(part.encoded);
+    emitOutbound(acct.cfg.id, line, messageId, part.summary);
   }
   respond(id, { result: { messageId } });
 }

package/runtime/node_modules/@metro-labs/xmtp/src/codecs.ts

@@ -166,6 +166,24 @@ export const SignatureReferenceCodec =
     c.signature ? `[Signature] ${c.signature}` : '[Signature]',
   );
 
+const xmtpOrg = (typeId: string): ContentTypeId => ({
+  authorityId: 'xmtp.org',
+  typeId,
+  versionMajor: 1,
+  versionMinor: 0,
+});
+export const WalletSendCallsCodec = makeJsonCodec<{ calls?: { metadata?: { description?: string } }[] }>(
+  xmtpOrg('walletSendCalls'),
+  (c) => {
+    const desc = c.calls?.[0]?.metadata?.description;
+    return desc ? `[Transaction request] ${desc}` : '[Transaction request]';
+  },
+);
+export const TransactionReferenceCodec = makeJsonCodec<{ reference?: string }>(
+  xmtpOrg('transactionReference'),
+  (c) => (c.reference ? `[Transaction] ${c.reference}` : '[Transaction]'),
+);
+
 export const ContentTypeFrame: ContentTypeId = {
   authorityId: 'stage.box',
   typeId: 'frame',

package/runtime/node_modules/@metro-labs/xmtp/src/conv-helpers.ts

@@ -89,7 +89,7 @@ export async function buildGroupInfo(
   const gn = (conv as unknown as { name?: string | (() => Promise<string>) })
     .name;
   const resolvedName = typeof gn === 'function' ? await gn() : (gn ?? '');
-  const { labels, github, preview } = readAppData(rawAppData);
+  const { labels, category, github, preview } = readAppData(rawAppData);
   return {
     line,
     id: conv.id,
@@ -98,6 +98,7 @@ export async function buildGroupInfo(
     name: resolvedName ?? '',
     memberCount: inboxIds.length,
     labels,
+    category,
     github,
     preview,
     assigned: Object.hasOwn(appData, 'assigned') ? appData.assigned : [],

package/runtime/node_modules/@metro-labs/xmtp/src/frames.ts

@@ -12,10 +12,10 @@ const TEXT_TYPES = new Set(['Text', 'Caption', 'Markdown']);
 
 type Node = Record<string, unknown>;
 
-const isNode = (v: unknown): v is Node =>
+export const isNode = (v: unknown): v is Node =>
   typeof v === 'object' && v !== null && !Array.isArray(v);
 
-const bad = (message: string): TrainError => new TrainError('INVALID_ARGS', message);
+export const bad = (message: string): TrainError => new TrainError('INVALID_ARGS', message);
 
 function plain(value: unknown): string {
   if (typeof value !== 'string') return '';
@@ -56,7 +56,7 @@ function clip(value: unknown, max: number, name: string): string | undefined {
   return out === '' ? undefined : out;
 }
 
-function parseJson(raw: unknown, name: string): unknown {
+export function parseJson(raw: unknown, name: string): unknown {
   if (typeof raw !== 'string') return raw;
   try {
     return JSON.parse(raw);

package/runtime/node_modules/@metro-labs/xmtp/src/labels.ts

@@ -14,13 +14,17 @@ const MAX_LABELS = 16;
 const MAX_LABEL_LEN = 24;
 const MAX_APP_DATA_BYTES = 8192;
 
+function cleanLabel(raw: string): string {
+  return raw.trim().replace(/\s+/g, ' ').slice(0, MAX_LABEL_LEN);
+}
+
 function cleanLabels(raw: unknown): string[] {
   if (!Array.isArray(raw)) return [];
   const out: string[] = [];
   const seen = new Set<string>();
   for (const item of raw) {
     if (typeof item !== 'string') continue;
-    const label = item.trim().replace(/\s+/g, ' ').slice(0, MAX_LABEL_LEN);
+    const label = cleanLabel(item);
     const key = label.toLowerCase();
     if (!label || seen.has(key)) continue;
     seen.add(key);
@@ -70,8 +74,13 @@ function trimmedString(v: unknown): string | undefined {
   return typeof v === 'string' && v.trim() ? v.trim() : undefined;
 }
 
+function cleanCategory(v: unknown): string | undefined {
+  return typeof v === 'string' ? cleanLabel(v) || undefined : undefined;
+}
+
 export function readAppData(appData: string | undefined): {
   labels: string[];
+  category?: string;
   github?: string;
   preview?: string;
 } {
@@ -82,6 +91,7 @@ export function readAppData(appData: string | undefined): {
     const rec = p as Record<string, unknown>;
     return {
       labels: cleanLabels(rec.labels),
+      category: cleanCategory(rec.category),
       github: trimmedString(rec.github),
       preview: trimmedString(rec.preview),
     };
@@ -97,33 +107,30 @@ function checkedLabels(value: unknown): string[] {
   return cleanLabels(value);
 }
 
+function checkedCategory(value: unknown): string | undefined {
+  if (value !== undefined && value !== null && typeof value !== 'string') {
+    throw new TrainError('INVALID_ARGS', 'category must be a string or null');
+  }
+  return cleanCategory(value);
+}
+
+const KNOWN_FIELDS = new Map<string, (value: unknown) => unknown>([
+  ['labels', checkedLabels],
+  ['assigned', normalizeAssigned],
+  ['github', (value) => normalizeGithubUrl(value) || undefined],
+  ['preview', (value) => normalizePreviewUrl(value) || undefined],
+  ['category', checkedCategory],
+]);
+
 function applyMergeKey(
   merged: Record<string, unknown>,
   k: string,
   v: unknown,
 ): void {
-  if (k === 'labels') {
-    merged.labels = checkedLabels(v);
-    return;
-  }
-  if (k === 'assigned') {
-    merged.assigned = normalizeAssigned(v);
-    return;
-  }
-  if (k === 'github') {
-    const g = normalizeGithubUrl(v);
-    if (g) merged.github = g;
-    else delete merged.github;
-    return;
-  }
-  if (k === 'preview') {
-    const p = normalizePreviewUrl(v);
-    if (p) merged.preview = p;
-    else delete merged.preview;
-    return;
-  }
-  if (v === undefined || v === null) Reflect.deleteProperty(merged, k);
-  else Object.defineProperty(merged, k, { value: v, enumerable: true, configurable: true, writable: true });
+  const normalize = KNOWN_FIELDS.get(k);
+  const value = normalize ? normalize(v) : v;
+  if (value === undefined || value === null) Reflect.deleteProperty(merged, k);
+  else Object.defineProperty(merged, k, { value, enumerable: true, configurable: true, writable: true });
 }
 
 export function mergeAppData(

package/runtime/node_modules/@metro-labs/xmtp/src/tools.ts

@@ -114,7 +114,7 @@ export const XMTP_TOOLS: StationTool[] = [
     group: 'read',
     description:
       "Read an XMTP channel's current metadata + membership. Args: line (required). Returns " +
-      '{line, id, account, version (dm|group), name, memberCount, labels, github, preview, ' +
+      '{line, id, account, version (dm|group), name, memberCount, labels, category, github, preview, ' +
       'assigned, appData (stored JSON object), rawAppData (stored JSON string), ' +
       'members:[{inboxId, address}]}. Syncs first and fails if metadata cannot be read. ' +
       'xmtp-only (daemon `groupInfo`). Use before ' +
@@ -171,10 +171,11 @@ export const XMTP_TOOLS: StationTool[] = [
       "Update an existing channel's metadata. Args: line (required, the metro:// line), and " +
       'any of metadata? (JSON object), github? (url), preview? (url), name? (string). ' +
       'metadata is a shallow appData patch: omitted keys are preserved, supplied nested ' +
-      'values replace that key, and null deletes custom keys. v is reserved. Put labels ' +
-      'and assigned inside metadata. assigned replaces the array with normalized lowercase ' +
+      'values replace that key, and null deletes custom keys. v is reserved. Put labels, ' +
+      'assigned and category inside metadata. assigned replaces the array with normalized lowercase ' +
       'Ethereum addresses of current members. Read group_info and union existing IDs to ' +
-      'add assignees. labels remains a legacy top-level alias. Duplicate top-level/metadata ' +
+      'add assignees. category is one string per channel (24 characters at most); "" or null ' +
+      'clears it. labels remains a legacy top-level alias. Duplicate top-level/metadata ' +
       'label/link aliases are refused. All fields use one updateChannelMeta call. xmtp-only. ' +
       'Returns updated metadata. Reread group_info to verify persistence.',
     inputSchema: {
@@ -191,6 +192,10 @@ export const XMTP_TOOLS: StationTool[] = [
               description: 'Replacement assignee list. Current member Ethereum addresses only. [] clears.',
               items: { type: 'string', pattern: '^0x[0-9a-fA-F]{40}$' },
             },
+            category: {
+              type: 'string',
+              description: 'The one category of the channel, 24 characters at most. "" clears it.',
+            },
             github: { type: 'string' },
             preview: { type: 'string' },
           },

package/runtime/node_modules/@metro-labs/xmtp/src/wallet.ts

@@ -0,0 +1,28 @@
+import type { EncodedContent } from '@xmtp/content-type-primitives';
+import {
+  SignatureReferenceCodec,
+  SignatureRequestCodec,
+  TransactionReferenceCodec,
+  WalletSendCallsCodec,
+} from './codecs.js';
+import { bad, isNode, parseJson } from './frames.js';
+
+const WALLET_TYPES: Record<string, { codec: { encode(c: Record<string, unknown>): EncodedContent }; needs: string[] }> = {
+  walletSendCalls: { codec: new WalletSendCallsCodec(), needs: ['version', 'chainId', 'from', 'calls'] },
+  transactionReference: { codec: new TransactionReferenceCodec(), needs: ['networkId', 'reference'] },
+  signatureRequest: { codec: new SignatureRequestCodec(), needs: ['id', 'kind'] },
+  signatureReference: { codec: new SignatureReferenceCodec(), needs: ['requestId', 'signature', 'signer'] },
+};
+
+export function buildWalletContent(raw: unknown): { encoded: EncodedContent; summary: string } {
+  const args = parseJson(raw, 'wallet');
+  const type = isNode(args) && typeof args.type === 'string' ? args.type : '';
+  const spec = Object.hasOwn(WALLET_TYPES, type) ? WALLET_TYPES[type] : undefined;
+  if (!isNode(args) || !spec) throw bad(`wallet type must be one of ${Object.keys(WALLET_TYPES).join(', ')}`);
+  const content = parseJson(args.content, 'wallet content');
+  if (!isNode(content)) throw bad(`wallet content must be the ${type} JSON object`);
+  const missing = spec.needs.filter((key) => content[key] === undefined);
+  if (missing.length > 0) throw bad(`${type} content needs ${missing.join(', ')}`);
+  const encoded = spec.codec.encode(content);
+  return { encoded, summary: encoded.fallback ?? type };
+}

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.247"
+  "version": "0.1.0-beta.249"
 }