Accès au JSON-RPC

Le devnet de Basis Network est un réseau public de développement, ouvert sur Internet, mais chaque requête nécessite un jeton nominatif. Vous trouverez ici tout ce qu’il faut pour vous connecter.

Ce n’est pas un environnement de production : ses LITHOS n’ont aucune valeur et la chaîne peut être réinitialisée sans préavis.

Configuration

Le jeton se place dans le chemin de l’URL, pas dans un en-tête. Il suffit d’exporter une variable pour que le CLI officiel fonctionne sans autre modification :

export BASIS_RPC_URL=https://rpc.basisnetwork.com.co/<votre-jeton>

La même URL fonctionne avec n’importe quel client qui parle JSON-RPC sur HTTPS :

curl -X POST https://rpc.basisnetwork.com.co/<votre-jeton> \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","method":"eth_blockNumber","params":[],"id":1}'

Chaque jeton identifie une personne et se révoque individuellement. Ne le publiez pas et ne le collez pas dans un dépôt : quiconque le détient communique avec le réseau en votre nom. En cas de fuite, demandez-nous-en un autre : nous révoquons l’ancien sur-le-champ.

Données du réseau

ParamètreValeur
Identifiant de chaîne 6969 (0x1b39)
Nom interne basis-devnet-6969
Monnaie LITHOS
Unité minimale tomo — 1 LITHOS = 1 000 000 000 tomos
Décimales 9
Frais de base minimaux 100 tomos par unité de gas
Coût d’un transfert 21 000 gas × 100 = 0,0021 LITHOS
Cadence des blocs ≈ 3 s, qu’il y ait des transactions ou non
Signatures ML-DSA-65 (FIPS 204)
Adresses 32 octets — BLAKE3 de la clé publique
Endpoint JSON-RPC rpc.basisnetwork.com.co/<votre-jeton>
Explorateur explorer.basisnetwork.com.co

Basis est post-quantique : ici, un portefeuille Ethereum ne peut que lire. Les adresses font 32 octets au lieu de 20 et les signatures sont en ML-DSA-65, pas en secp256k1 : MetaMask et les portefeuilles similaires peuvent donc interroger la chaîne, mais pas signer de transaction pour elle. Pour envoyer des transactions, utilisez le CLI de Basis ou le portefeuille officiel.

Limites

LimiteValeur
Requêtes par adresse IP25/s en continu, pics jusqu’à 50
Appels par lot100
Méthodes activées38 (voir ci-dessous)
Taille d’un transfert≈ 5 444 octets sur le réseau

Dépasser ce débit renvoie 429 ; appeler une méthode absente de la liste renvoie une erreur JSON-RPC, pas une erreur réseau. Le devnet ne conserve pas l’état historique : les requêtes sur des blocs anciens — eth_call ou eth_getBalance à une hauteur passée — échouent, et c’est voulu. Interrogez toujours le bloc latest.

Méthodes disponibles

Les méthodes eth_* forment l’interface de compatibilité ; les basis_* sont les méthodes natives, et les seules à comprendre les adresses de 32 octets sans les tronquer.

  • eth_blockNumber
  • eth_chainId
  • net_version
  • web3_clientVersion
  • eth_getBlockByNumber
  • eth_getBlockByHash
  • eth_getTransactionByHash
  • eth_getTransactionReceipt
  • eth_getTransactionByBlockNumberAndIndex
  • eth_getTransactionByBlockHashAndIndex
  • eth_getBalance
  • eth_getCode
  • eth_getStorageAt
  • eth_getLogs
  • eth_call
  • eth_estimateGas
  • eth_gasPrice
  • eth_maxPriorityFeePerGas
  • eth_feeHistory
  • eth_getTransactionCount
  • eth_syncing
  • eth_getUncleByBlockHashAndIndex
  • eth_sendRawTransaction
  • eth_getBlockReceipts
  • eth_getBlockTransactionCountByNumber
  • basis_blockNumber
  • basis_resolveAddress
  • basis_getRawTransaction
  • basis_getBlockConsensus
  • basis_getBalance
  • basis_getTransactionCount
  • basis_getBlock
  • basis_getBlocks
  • basis_chainId
  • basis_getSubnets
  • basis_getValidators
  • basis_getAccount
  • basis_getReceipt

Obtenir un jeton

Sur le Discord de Basis Network, tapez /rpc-token et décrivez en une phrase ce que vous allez construire. La demande parvient à l’équipe et, dès que quelqu’un l’approuve, le bot vous envoie l’URL complète par message privé. Autorisez les messages privés pour ce serveur, sinon le bot ne pourra pas vous l’envoyer.

Un jeton par personne : si vous le redemandez, vous recevez le même. Si vous préférez l’e-mail, écrivez-nous à contact@basisnetwork.com.co.

Besoin de LITHOS de test ? Allez au faucet