# FAR — Free Asset Resolver

> A free, static, key-less resolver between CoinGecko ids and CAIP-19 chain-agnostic asset identifiers. Give it a CoinGecko id and get every chain the asset is deployed on as a standards-compliant CAIP-19; give it a CAIP-19 and get the CoinGecko id, so on-chain data can be priced. Every lookup is a plain JSON file at a predictable URL under https://0xcounting.github.io/FAR. There is no server, no authentication, no rate limit, and every file is sha256-hashed into a Merkle-rooted manifest with a per-file inclusion proof.

Names and tickers are not unique. The /name and /symbol routes therefore return a GROUP of distinct assets, and each asset carries a `family` field saying whether it is the canonical asset others are named after, a self-declared wrapper of one, or standalone. Use it to pick the right USDC out of sixty.

To use it: fetch `index.json` for live counts and the route list, then fetch the route you need. Prefer one file per query over the bulk dump unless you need the whole registry. CoinGecko ids and CAIP-19s are case-sensitive as published; names and tickers are looked up by slug (lowercased, punctuation to `-`).

## Start here

- [index.json](https://0xcounting.github.io/FAR/index.json): counts, source snapshot hashes, and the full route list. Fetch this first.
- [openapi.json](https://0xcounting.github.io/FAR/openapi.json): OpenAPI 3.1 description of every route and response shape.
- [README](https://0xcounting.github.io/FAR/README.md): the human documentation, in Markdown.
- [llms-full.txt](https://0xcounting.github.io/FAR/llms-full.txt): this file plus the README and contributor guide inlined, for a single-fetch context.

## Routes

- [/cg/{coingeckoId}.json](https://0xcounting.github.io/FAR/cg/tether.json): one asset by CoinGecko id, with every chain deployment as a CAIP-19, its naming family, and related assets.
- [/caip/{ns}/{ref}/{assetNs}/{assetRef}.json](https://0xcounting.github.io/FAR/caip/eip155/1/erc20/0xdac17f958d2ee523a2206206994597c13d831ec7.json): the asset at an exact CAIP-19. The identifier is written as a path: `:` and `/` become `/`, and `%` becomes `~`.
- [/name/{slug}.json](https://0xcounting.github.io/FAR/name/tether.json): every asset with that name. Always a group, never one asset, because names are not unique.
- [/symbol/{slug}.json](https://0xcounting.github.io/FAR/symbol/usdc.json): every asset with that ticker. `usdc` returns 60+; use `family` to tell the canonical one from wrappers.
- [/far.json.gz](https://0xcounting.github.io/FAR/far.json.gz): the entire registry as one gzipped JSON, about 1.8 MB.
- [/search-index.json](https://0xcounting.github.io/FAR/search-index.json): compact array the site searches client-side; useful for fuzzy lookup in your own process.

## Trust

- [/_platforms.json](https://0xcounting.github.io/FAR/_platforms.json): every chain mapping with its `confidence` and `evidence`. A deployment's `confidence` is inherited from its chain.
- [/_namespace-gaps.json](https://0xcounting.github.io/FAR/_namespace-gaps.json): CAIP-2 and CAIP-19 namespaces this registry had to choose because no CASA specification defines them. A CAIP-19 on Cosmos, Tron, Sui, Aptos or TON is this project's proposal, not a ratified standard.
- [/_platforms.json](https://0xcounting.github.io/FAR/_platforms.json): every chain mapping with its `confidence` and `evidence`.
- [/_chains.json](https://0xcounting.github.io/FAR/_chains.json): CAIP-2 -> chain identity for every chain the registry can name, independent of CoinGecko platforms (Cosmos today), so an IBC voucher's origin is always nameable.
- [/_ics20-unplaced.json](https://0xcounting.github.io/FAR/_ics20-unplaced.json): IBC vouchers whose mapping is verified (the ibc/ hash recomputes from path + base denom) but whose origin asset has no CoinGecko id; each carries the origin CAIP-19 it is equivalent to. Deployments with a `verified` object are this class: proven, not reviewed.

## Verification

- [/manifest.json](https://0xcounting.github.io/FAR/manifest.json): sha256 of every file and the Merkle root of the release (11 MB).
- [/manifest.sha256](https://0xcounting.github.io/FAR/manifest.sha256): the root on one line, for pinning.
- [/proof/{path without .json}.json](https://0xcounting.github.io/FAR/proof/cg/tether.json): a file's inclusion proof (about 17 hashes) so one response can be checked against the root without the manifest.

## Optional

- [Contributing](https://github.com/0xcounting/FAR/blob/main/CONTRIBUTING.md): how to map a chain, raise a confidence level, dispute an identifier, or add a native asset. Every change is a reviewed pull request with cited evidence.
- [Governance](https://github.com/0xcounting/FAR/blob/main/GOVERNANCE.md): who decides, how disputes are resolved, what the project will not do.
- [Sources and licences](https://github.com/0xcounting/FAR/blob/main/SOURCES.md): per-source terms. Code is MIT; curated tables are CC0; CoinGecko and chain data keep their own terms.
- [/.well-known/api-catalog](https://0xcounting.github.io/FAR/.well-known/api-catalog): RFC 9727 API catalog pointing at the OpenAPI description.
- [Source repository](https://github.com/0xcounting/FAR)