# Find3r

> A lightweight, static browser for apps, files, Art Blocks artworks and ABX items. BAMFS read-only recovery uses EVM JSON-RPC and never requires a Find3r server or BAMFS/ABX content gateway.

- [Agent recovery guide](./AGENTS.md): complete read path, commands, self-hosting, security boundaries, and supported scope.
- [Exact specification](./spec/site-v0.md): contract signatures, hash formulas, compression, and resource limits.
- [Deployment map](./deployments.json): original chain, collection, enumeration, history, directory, file, and content store addresses.
- [Standalone tool](./agent/recover.mjs): download once; Node 22.13+; no npm installation or gateway needed at recovery time. Use --help.
- [Human guide](./learn.html): browsing, recovery, self-hosting, and sandbox limitations.

Select an item and choose Open independently for a machine-readable find3r-recovery-v1 descriptor containing chainId, collection, tokenId, fixed version, rootCid, stores, and path. Descriptors and receipts exclude RPC URLs and credentials.

Wallets load Apps, Art Blocks or ABX on demand. Art Blocks project folders/search/counts use exact-owner queries on Ethereum, Arbitrum and Base (including indexed Engine collections); contract folders show projects without an owner filter. Recently collected sorts the full indexed token scope by last_transferred_at; newest minted uses minted_at. Pages are bounded to 40. ABX groups owned ERC-721 tokens/positive ERC-1155 holdings in registered public-resolver collections, then opens metadata images/live views/features. ABX sorts numerically because its projections lack consistent mint/transfer dates. Both discovery paths use hosted indexes and are not a complete or verified chain inventory. Generic IPFS NFT discovery is not implemented.

Art Blocks descriptors use find3r-artwork-v1; the standalone tool supports Ethereum artworks via the on-chain generator, with other chains requiring manual recovery. ABX descriptors use find3r-abx-v1; the bundled tool does not yet support them. Follow AGENTS.md#abx for tokenURI/uri, reader/field-renderer/generator reads, deployment discovery, external dependency checks and CLI/SDK recovery. Never copy full ABX project projections (service configuration) into a descriptor. Failed categories remain failures rather than proof of no holdings.

The token-style web3:// address is Find3r's BAMFS convention, not general ERC-4804 compatibility. The browser treats bare token and /latest/ links as the current BAMFS head and freezes the result into a fixed version. Explicit /v/N/ locators never follow latest. The low-level recovery tool expects fixed versions; its legacy abbreviated locator selects version 1.

No Find3r publication identity is recorded in this build yet. Do not claim that Find3r itself is onchain until publication and recovery verification are complete.

Artwork links open artwork.html#chain=CHAIN&contract=CONTRACT&token=TOKEN. This static detail page shows the image, features and project information and offers separate live-view and full-screen image actions. Full Art Blocks metadata is fetched when a piece is opened; derived image/live links remain usable if metadata fails. ABX listing pages fetch standard metadata for up to 40 pieces; details retry it and only offer actions supplied by metadata.