@zkproofport-ai/sdk 0.2.14 → 0.2.15

package/README.md

@@ -2,7 +2,7 @@
 
 Client SDK for ZKProofport zero-knowledge proofs, including experimental exact-action authorization on Arc Testnet.
 
-The shared `hashTypedAction` helper and corrected Arc stepwise signing require SDK/MCP **0.2.12 or later**. Release Please owns the versions. Confirm the resolved npm versions before using this path.
+The shared `hashTypedAction` helper is available from **SDK 0.2.12**. Arc/GIWA optional actions require **SDK 0.2.14 or later**; MCP stepwise input preparation requires **MCP 0.2.15 or later**. Release Please owns the versions. Confirm the resolved npm versions before using this path.
 
 ## Overview
 
@@ -85,7 +85,7 @@ An endpoint without that key receives readable circuit inputs over HTTPS and pro
 npm install @zkproofport-ai/sdk@latest ethers
 ```
 
-Corrected Arc stepwise support and shared action hashing require SDK/MCP **0.2.12 or later**. Install from npm and check the resolved version. Release Please manages package versions and the release workflow publishes them; repository source changes alone do not update `@latest`.
+Use **SDK 0.2.14 or later** and **MCP 0.2.15 or later** for both Arc/GIWA signature modes, including stepwise preparation. Install from npm and check the resolved version. Release Please manages package versions and the release workflow publishes them; repository source changes alone do not update `@latest`.
 
 ## Prerequisites
 
@@ -650,7 +650,7 @@ function fromSigner(signer: ethers.Signer): ProofportSigner;
 ```typescript
 interface ProofParams {
   circuit: CircuitName;
-  action?: { domain: { name: string; version: string; chainId: number; verifyingContract: string }; types: Record<string, Array<{name: string; type: string}>>; primaryType: string; message: Record<string, unknown> }; // required only for arc_eligibility
+  action?: { domain: { name: string; version: string; chainId: number; verifyingContract: string }; types: Record<string, Array<{name: string; type: string}>>; primaryType: string; message: Record<string, unknown> }; // optional for arc_eligibility and giwa_attestation
   payOn?: string;
   maxPayment?: string; // decimal USDC
   approvedPayment?: ApprovedPayment;
@@ -747,3 +747,32 @@ Common errors:
 ## License
 
 MIT
+
+
+### Testing the published packages
+
+From the `proofport-ai` repository root, use the isolated registry runner:
+
+```bash
+E2E_BASE_URL=https://stg-ai.zkproofport.app \
+E2E_PAYMENT_NETWORK=base-sepolia \
+npm run test:e2e:published -- --sdk-version 0.2.14 --mcp-version 0.2.15
+```
+
+It installs those exact npm versions outside the workspace, resolves SDK imports
+and the MCP process to that installation, and removes it afterwards. The runner
+also installs and verifies Circle CLI 1.1.4, automatically putting it on the test
+subprocess PATH without changing the global installation. A normal
+workspace test run exercises local packages and is not published-package evidence.
+The full suite creates paid testnet proofs. It requires the attestation and payer
+credentials loaded by `tests/setup.ts`; GIWA uses `GIWA_ATTESTATION_KEY`, and OIDC
+uses `E2E_OIDC_JWT` or an authenticated gcloud account. The payment matrix checks
+Base Sepolia, Arc immediate settlement, Ethereum Sepolia, and Arc Gateway nano
+separately, so each needs a funded payer on its selected network. Optional
+`E2E_PAYER_KEY_<NETWORK>` overrides use uppercase names with underscores, for
+example `E2E_PAYER_KEY_ETHEREUM_SEPOLIA`. `E2E_ARC_AGENT_ADDRESS` selects an
+existing Circle Agent Wallet for both Arc cases; the supported Circle CLI,
+on-chain USDC for immediate settlement, and Gateway USDC for nano are required. The runner never deposits or transfers funds.
+
+For a non-paying package/discovery check, append
+`-t 'should list all 5 circuits'`. This checks discovery only, not proof generation.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zkproofport-ai/sdk",
-  "version": "0.2.14",
-  "description": "TypeScript SDK for ZKProofport identity proofs and experimental Arc Testnet EIP-712 action authorization. Circle Agent Wallet payments, Circle Gateway nanopayments and x402 USDC; Coinbase KYC, country and OIDC proofs.",
+  "version": "0.2.15",
+  "description": "TypeScript SDK for ZKProofport Coinbase KYC, country, OIDC, Arc eligibility and GIWA attestation proofs. Optional EIP-712 action binding for Arc/GIWA; x402 USDC and Circle Gateway payments.",
   "keywords": [
     "sdk",
     "typescript",