Skip to content

CLAUDE.md

Latest commit

 

History

History
37 lines (27 loc) · 1.51 KB

CLAUDE.md

File metadata and controls

37 lines (27 loc) · 1.51 KB
Raw

AGENTS.md

Decentralized web fetch library (@1001-digital/dweb-fetch) — fetch content from IPFS, IPNS, Arweave, HTTPS, and EIP-155 NFT references.

Code style

  • TypeScript
  • Single quotes, no semicolons

Structure

  • src/ — Source code
  • src/index.ts — Factory (createDwebFetch) + barrel exports
  • src/types.ts — Public types
  • src/errors.ts — Error classes
  • src/utils/parse-url.ts — URL scheme extraction + EIP-155 URI parsing
  • src/utils/abi.ts — Minimal ABI encode/decode for ERC-721/1155 tokenURI calls
  • src/protocols/ — Protocol handlers (ipfs, arweave, https, eip155)
  • test/ — Vitest tests (mirrors src structure)

Key patterns

  • Vite build step — outputs JS + .d.ts to dist/, source TS published alongside for editor navigation
  • Lazy backend init — createDwebFetch() is synchronous; backends initialize on first fetch() call
  • Dynamic imports — @helia/verified-fetch and @ar.io/wayfinder-core imported at runtime for tree-shaking
  • Cached promise pattern for concurrent-safe lazy init
  • EIP-155 handler is opt-in — only active when eip155 config with rpcUrls is provided; uses startsWith('eip155:') routing (like data:) since the URI format has no ://
  • EIP-155 handler delegates resolved tokenURIs back to the parent DwebClient via a () => client closure

Testing

pnpm test        # run once
pnpm test:watch  # watch mode

Tests mock all external dependencies (@helia/verified-fetch, @ar.io/wayfinder-core, globalThis.fetch).