Release v0.8.0

Origin-SHA: 32f9800bc76568439c94b901220645f6e14f2fbc

Co-authored-by: Cody <132297275+CodySearsOS@users.noreply.github.com>

Author: ryanio

AGENTS.md

@@ -21,7 +21,7 @@ pnpm run type-check  # TypeScript type checking
 | `src/index.ts` | Library entry point — public `tool-sdk` exports |
 | `src/cli.ts` | CLI entry point (Commander program wiring) |
 | `src/types.ts` | Shared public types |
-| `src/cli/commands/` | CLI commands: `auth`, `deploy`, `dry-run-gate`, `dry-run-predicate-gate`, `export`, `hash`, `init`, `inspect`, `pay`, `register`, `smoke`, `update-metadata`, `validate`, `verify` |
+| `src/cli/commands/` | CLI commands: `auth`, `deploy`, `dry-run-gate`, `dry-run-predicate-gate`, `export`, `get-collections`, `hash`, `init`, `inspect`, `pay`, `register`, `set-collection-tokens`, `set-collections`, `smoke`, `update-metadata`, `validate`, `verify` |
 | `src/lib/onchain/abis.ts` | TypeScript ABI definitions mirroring Solidity interfaces |
 | `src/lib/onchain/chains.ts` | Deployed contract addresses per chain |
 | `src/lib/onchain/registry.ts` | `ToolRegistryClient` — onchain interaction wrapper |
@@ -35,6 +35,7 @@ pnpm run type-check  # TypeScript type checking
 | `src/lib/adapters/` | Framework adapters (Vercel, Cloudflare, Express) |
 | `src/lib/utils.ts` | Shared utilities used across `lib/` |
 | `src/templates/` | Scaffolding templates for `init` command |
+| `src/testing/` | Test helpers exported via `@opensea/tool-sdk/testing` subpath |
 | `src/__tests__/` | Vitest test suite |
 
 ## Review Checklist

CHANGELOG.md

@@ -1,5 +1,16 @@
 # @opensea/tool-sdk
 
+## 0.8.0
+
+### Minor Changes
+
+- 6eacfbe: Add `IWalletStateAttestation` requirement type support (kind `0x7a111640`)
+
+  - New `WALLET_STATE_ATTESTATION_KIND` constant and `DecodedWalletStateAttestationRequirement` type
+  - `decodeRequirement()` now decodes wallet-state attestation data (`issuerJwksUri`, `conditionHash`)
+  - CLI `inspect` command displays decoded attestation fields for `WalletStateAttestationPredicate`
+  - SKILLS.md updated with WalletStateAttestation predicate documentation
+
 ## 0.7.1
 
 ### Patch Changes

SKILLS.md

@@ -758,6 +758,50 @@ const op = await composite.getOp(toolId)     // CompositeOp.ALL or CompositeOp.A
 const terms = await composite.getTerms(toolId) // [{ predicate, negate }]
 ```
 
+### WalletStateAttestationPredicate
+
+Gates access based on offchain-signed wallet-state attestations. Designed for cross-chain wallet state that cannot be evaluated natively in EVM (e.g., Solana, XRPL, Bitcoin holdings). An offchain issuer evaluates conditions against the relevant chain, signs a verdict, and the onchain predicate verifies the signature via the RIP-7212 P-256 precompile.
+
+| Field | Value |
+|-------|-------|
+| Requirement `kind` | `0x7a111640` (`IWalletStateAttestation` interface ID) |
+| Requirement `data` (getRequirements) | `abi.encode(string issuerJWKSURI, bytes32 conditionHash)` |
+| Proof `data` (hasAccess) | `abi.encode(bool pass, address wallet, bytes32 conditionHash, uint256 blockNumber, bytes32 r, bytes32 s, bytes32 messageHash)` |
+| Signature verification | ECDSA P-256 via RIP-7212 precompile (~3,450 gas) |
+
+This is a third-party predicate type. No canonical deployment exists; each issuer deploys their own instance. The `IWalletStateAttestation` marker interface is not pinned in `IRequirementTypes.sol` but is a valid extension per the spec's open `kind` namespace.
+
+**Decode requirements via SDK:**
+```typescript
+import { decodeRequirement, WALLET_STATE_ATTESTATION_KIND } from "@opensea/tool-sdk"
+
+const decoded = decodeRequirement(req)
+if (decoded.type === "walletStateAttestation") {
+  // decoded.issuerJwksUri — URL to fetch the issuer's JWKS public key set
+  // decoded.conditionHash — identifies which condition set the predicate enforces
+  console.log(`Issuer JWKS: ${decoded.issuerJwksUri}`)
+  console.log(`Condition:   ${decoded.conditionHash}`)
+}
+```
+
+**Manifest access declaration (manual):**
+```json
+{
+  "access": {
+    "logic": "AND",
+    "requirements": [
+      {
+        "kind": "0x7a111640",
+        "data": "<abi.encode(string issuerJWKSURI, bytes32 conditionHash)>",
+        "label": "Cross-chain wallet attestation required"
+      }
+    ]
+  }
+}
+```
+
+**Reference implementation:** [douglasborthwick-crypto/insumer-examples](https://github.com/douglasborthwick-crypto/insumer-examples)
+
 ### SDK Helpers for Reading Predicate Requirements
 
 Use `describeToolAccess` to read a tool's predicate name, requirements, and logic from the registry, and `decodeRequirement` to decode the raw `kind`/`data` into typed objects:
@@ -780,6 +824,9 @@ for (const req of description.requirements) {
     case "subscription":
       console.log(`Requires subscription (min tier ${decoded.minTier}) from ${decoded.collection}`)
       break
+    case "walletStateAttestation":
+      console.log(`Requires attestation from ${decoded.issuerJwksUri} (condition: ${decoded.conditionHash})`)
+      break
     case "unknown":
       console.log(`Unknown requirement kind ${decoded.kind}`)
       break