w3_bridge_generate_tokens

Generate authentication tokens for the UCAN-HTTP bridge, enabling delegated capabilities and expiration settings for secure access to MCP IPFS server resources.

Instructions

Generates authentication tokens for using the UCAN-HTTP bridge.

Input Schema

TableJSON Schema

Name	Required	Description
`capabilities`	Yes	One or more capabilities to delegate (e.g., ['space/info']).
`expiration`	No	Unix timestamp (in seconds) for expiration. Zero means no expiration.
`json`	No	Output JSON suitable for fetch headers (default: true).

Implementation Reference

src/tool_handlers.ts:430-485 (handler)

The primary handler function for the 'w3_bridge_generate_tokens' tool. Validates input arguments using the corresponding Zod schema, constructs the 'w3 bridge generate-tokens' CLI command based on capabilities, expiration, and json flag, executes it via runW3Command utility, handles JSON parsing, and formats the response as MCP content.

const handleW3BridgeGenerateTokens: ToolHandler = async (args) => {
  const parsed = Schemas.W3BridgeGenerateTokensArgsSchema.safeParse(args);
  if (!parsed.success)
    throw new Error(
      `Invalid arguments for w3_bridge_generate_tokens: ${parsed.error.message}`
    );
  const { capabilities, expiration, json } = parsed.data;
  let command = "bridge generate-tokens";
  capabilities.forEach((cap) => {
    command += ` --can '${cap}'`;
  });
  if (expiration !== undefined) command += ` --expiration ${expiration}`;
  if (json) command += " --json";
  const { stdout } = await runW3Command(command);
  if (json) {
    try {
      const tokenData = JSON.parse(stdout);
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              message: "Bridge tokens generated (JSON format).",
              tokenData,
            }),
          },
        ],
      };
    } catch (e) {
      logger.warn("Failed to parse bridge tokens JSON, returning raw.");
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify({
              message: "Bridge tokens generated (raw output).",
              output: stdout.trim(),
            }),
          },
        ],
      };
    }
  } else {
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({
            message: "Bridge tokens generated (raw output).",
            output: stdout.trim(),
          }),
        },
      ],
    };
  }
};

src/schemas.ts:168-188 (schema)

Zod schema defining the input parameters for the 'w3_bridge_generate_tokens' tool, including required capabilities array, optional expiration timestamp, and json output flag with descriptions.

export const W3BridgeGenerateTokensArgsSchema = z
  .object({
    capabilities: z
      .array(z.string())
      .min(1)
      .describe("One or more capabilities to delegate (e.g., ['space/info'])."),
    expiration: z
      .number()
      .int()
      .positive()
      .optional()
      .describe(
        "Unix timestamp (in seconds) for expiration. Zero means no expiration."
      ),
    json: z
      .boolean()
      .optional()
      .default(true)
      .describe("Output JSON suitable for fetch headers (default: true)."),
  })
  .describe("Generates authentication tokens for using the UCAN-HTTP bridge.");

src/tool_handlers.ts:961-961 (registration)
Maps the tool name 'w3_bridge_generate_tokens' to its handler function in the exported toolHandlers object, which is imported and used by the main MCP server in index.ts to dispatch tool calls.
```
w3_bridge_generate_tokens: handleW3BridgeGenerateTokens,
```

mcp-ipfs