b-open-io/clawnet-cli

ClawNet CLI

Vault Architecture (v0.0.33)

ClawNet CLI uses @1sat/[email protected] and @1sat/wallet-mac for key management. The old configureVault() helper and built-in se-helper binary have been removed.

The vault is composed from three pieces:

1. SecureEnclaveProvider from @1sat/wallet-mac — platform-specific Secure Enclave operations. Instantiated with SecureEnclaveProvider({ name: "ClawNet" }).
2. FileVaultStorage from @1sat/vault — file-based vault entry storage.
3. createVault(provider, storage) from @1sat/vault — creates the vault instance from a provider and storage backend.

import { SecureEnclaveProvider } from "@1sat/wallet-mac";
import { FileVaultStorage, createVault } from "@1sat/vault";

const provider = new SecureEnclaveProvider({ name: "ClawNet" });
const storage = new FileVaultStorage();
const vault = createVault(provider, storage);

ORDFS Directory Traversal (v0.0.32)

clawnet add fetches files via /content/{manifest}/{path} directory paths. ORDFS resolves _N refs and nested directories natively, so the CLI no longer needs to parse them manually. The old downloadDirectoryEntries function with manual _N parsing was removed.

Example fetch path:

https://ordfs.network/content/{manifestTxid}/src/index.ts

ORDFS handles the directory tree resolution server-side.

Organization Publishing

clawnet publish ORGANIZATION.md publishes organization packages with an agent hierarchy (roles, reporting structure).

The ORGANIZATION.md format uses YAML frontmatter with an agents: array:

---
name: my-org
agents:
  - slug: lead-agent
    role: lead
  - slug: worker-agent
    role: worker
    reportsTo: lead-agent
---

Each agent entry supports:

• slug — agent identifier (must match a published agent)
• role — the agent's role within the organization
• reportsTo — slug of the agent this one reports to (establishes hierarchy)

Agent Publish with Icons

Agent .md files support an icon: field in YAML frontmatter. The icon URL points to an avatar image that is stored in the registry and served via the API.

---
name: my-agent
icon: https://example.com/avatar.png
---