adamant-wallets

# ADAMANT wallet metadata

This repository contains canonical coin, token, blockchain, node, service, icon, and schema metadata used by ADAMANT apps.

The data is optimized for wallet behavior, display, node/service reliability, and downstream compatibility.

## Structure

- `assets/general/<coin-or-token>/info.json` - shared coin or token metadata
- `assets/general/<coin-or-token>/images/` - icon assets for PWA and iOS apps
- `assets/blockchains/<blockchain>/info.json` - blockchain-level metadata and defaults
- `assets/blockchains/<blockchain>/<token>/info.json` - token overrides for a specific blockchain
- `specification/openapi.json` - OpenAPI schema for the metadata objects

## Override model

Consumers should read metadata in this order:

1. Load shared metadata from `assets/general/<coin-or-token>/info.json`
2. Apply blockchain defaults from `assets/blockchains/<blockchain>/info.json` when the asset belongs to a blockchain family
3. Apply token-specific blockchain overrides from `assets/blockchains/<blockchain>/<token>/info.json`

The JSON assets are the implementation source of truth for current wallet metadata. If this README or `specification/openapi.json` disagrees with assets, fix the documentation or schema drift without changing wallet behavior silently.

## Blockchain metadata

Each blockchain directory includes an `info.json` file that points to the main coin and the coin used for fees:

```jsonc
{
  "blockchain": "Ethereum", // Blockchain readable name
  "type": "ERC20", // How an app should mark token blockchain
  "mainCoin": "ethereum", // A coin containing parameters common to the blockchain
  "fees": "ethereum", // Coin to pay fees in
  "defaultGasLimit": 60000, // Optional. Fallback gas limit for Ethereum-like transfers
  "defaultGasPriceGwei": 40, // Optional. Fallback gas price in Gwei
  "reliabilityGasLimitPercent": 110, // Optional. Gas limit multiplier percent for safer tx acceptance
  "reliabilityGasPricePercent": 110, // Optional. Gas price multiplier percent for safer tx acceptance
  "increasedGasPricePercent": 120, // Optional. Multiplier percent for the "Increase fee" option
}
```

Navigate to `assets/general/${mainCoin}` to get explorer links, address validation, services, nodes, icons, and other shared blockchain parameters.

## Coin and token metadata

Coin and token metadata is stored in `assets/general/${token_name}/info.json`. Blockchain-specific files may override fields for assets issued on a specific chain.

```jsonc
{
  "name": "Example Coin", // Readable coin name
  "nameShort": "Example", // Optional. Readable coin short name
  "website": "https://example.com", // Project website URL
  "description": "Example coin metadata.", // Short description

  "explorer": "https://explorer.example.com", // Optional. Explorer URL
  "explorerTx": "https://explorer.example.com/tx/${ID}", // Optional. URL to get tx info
  "explorerAddress": "https://explorer.example.com/address/${ID}", // Optional. URL to get address i