@iicp/client 0.7.37 → 0.7.39

package/README.md

@@ -73,6 +73,24 @@ const result = await client.submit({
 
 ---
 
+## Use as a local API proxy (OpenAI / Ollama / Anthropic compat)
+
+Run a local gateway that speaks the OpenAI, Ollama, and Anthropic HTTP APIs and routes
+every request across the IICP mesh — point any tool you already use at it, no code changes.
+
+```bash
+npm i -g @iicp/client
+iicp-node proxy                       # → http://127.0.0.1:9483
+
+export OPENAI_BASE_URL=http://127.0.0.1:9483/v1   # OpenAI SDK / LangChain / Cursor / liteLLM
+export OLLAMA_HOST=http://127.0.0.1:9483          # Open WebUI / Continue.dev / aider / Jan
+```
+
+Loopback-only consumer (never registers with the directory), built on Node's `http` (no
+extra runtime dependency). Override the port with `--port` / `IICP_PROXY_PORT`; co-host
+next to a node with `iicp-node serve --with-proxy`. Every response carries
+`Server: iicp-proxy`. Full guide: <https://iicp.network/docs/proxy>
+
 ## Configuration
 
 ```typescript
@@ -308,6 +326,30 @@ IICP_RELAY_WORKER_ENDPOINT=host:9485    # specific relay instead of auto-elect
 
 ---
 
+## Operator identity
+
+Your **operator identity** is an ed25519 keypair — its public key *is* your `operator_id` (the
+directory stores it as `operator_pubkey`). One identity spans every node you run: it binds them to
+you (nodes show **`Operated by <your name>` ✓**), earns a
+[founder ordinal](https://iicp.network/founders), and rolls each node's credits into one operator
+wallet. Your `display_name` is the public, mutable handle; your contact stays local.
+
+```bash
+iicp-node init                       # create your key-backed identity (~/.iicp/operator.json)
+iicp-node serve --node mynode        # signs an operator→node delegation; binds the node to you
+iicp-node operator rename "NewName"  # change your public display_name (signed)
+iicp-node operator encrypt           # password-encrypt the secret at rest ($IICP_OPERATOR_PASSPHRASE)
+iicp-node operator decrypt           # remove at-rest encryption
+```
+
+**The key is the identity** — whoever holds `~/.iicp/operator.json` controls it (its nodes, ordinal,
+and wallet); there is no central recovery. Back it up (encrypted), never commit or share it; lose it
+and the identity, with its founder ordinal, is gone.
+
+Full guide: **[iicp.network/docs/operator-identity](https://iicp.network/docs/operator-identity)**
+
+---
+
 ## SDK conformance
 
 | Rule | Description | Status |
@@ -328,7 +370,7 @@ Conformance tier: `iicp:sdk:v1` (spec S.14) · [Request a badge](https://iicp.ne
 ```bash
 npm install        # install deps
 npm run typecheck  # tsc strict
-npm test           # 224 unit tests
+npm test           # run the unit suite
 npm run build      # emit to dist/
 ```
 

package/dist/cli.d.ts

@@ -21,7 +21,19 @@ export interface ServeOpts {
     relayWorkerEndpoint: string;
     node: string;
     logDir?: string;
+    withProxy?: boolean;
 }
 export declare function applySavedNode(opts: ServeOpts, saved: NodeIdentity): ServeOpts;
+/**
+ * #456 --verify: cryptographically confirm this node's CREDIT_AWARD income against the
+ * directory's signed event log (defends against a lying directory). Resolves the directory's
+ * Ed25519 key from /.well-known/did.json and re-derives + verifies each award signature.
+ * Free-tier CREDIT_ALLOCATION is unsigned by design, so it is not counted here (no cry-wolf).
+ */
+export declare function verifyCreditAwards(directoryUrl: string, nodeId: string): Promise<{
+    sum: number;
+    verified: number;
+    failed: number;
+}>;
 export declare function main(argv?: string[]): Promise<number>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAiCA,OAAO,EASL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qGAAqG;IACrG,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAkXD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,CAqB9E;AA2aD,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CA8FlF"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAwCA,OAAO,EAcL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAGvB,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,qGAAqG;IACrG,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB,EAAE,OAAO,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAsXD,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,CAqB9E;AA4mBD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA+D5D;AAsTD,wBAAsB,IAAI,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,MAAM,CAAC,CAmGlF"}