Voir la table des matières pour une liste de guides, y compris un guide de l'exploreur, un guide pour les chasseurs de satoshis et un guide des inscriptions.
7.1 Exploreur ordinal
Le binaire ord comprend un exploreur de blocs. Nous hébergeons une instance de l'exploreur de blocs sur mainnet à ordinals.com, et sur signet à signet.ordinals.com.
Faire tourner l'exploreur
Le serveur peut être exécuté localement avec :
ord server
Pour spécifier un port, ajoutez l'option --http-port :
ord server --http-port 8080
Pour activer les points d'entrée JSON-API, ajoutez l'option --enable-json-api ou -j (voir ici pour plus d'informations) :
ord --enable-json-api server
Pour tester l'aspect de vos inscriptions, vous pouvez lancer la commande suivante
ord preview <FILE1> <FILE2> ...
Recherche
La fonction de recherche accepte une variété de représentations d'objets.
Blocs
Les blocs peuvent être recherchés par hachage, par exemple, le bloc genesis :
000000000019d6689c085ae165831e934ff763ae46a2a6c172b3f1b60a8ce26f
Transactions
Les transactions peuvent être recherchées par hachage, par exemple, la transaction genesis block coinbase :
4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b
Sorties
Les sorties de transaction peuvent être recherchées par outpoint, par exemple, la seule sortie de la transaction genesis block coinbase :
4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b:0
Sats
Les Sats peuvent être recherchés par nombre entier, leur position dans l'ensemble de l'offre de bitcoins :
Par décimale, leur bloc et leur décalage dans ce bloc :
Par degré, leur cycle, les blocs depuis le dernier halving, les blocs depuis le dernier ajustement de difficulté, et le décalage dans leur bloc :
Par leur nom, leur représentation en base 26 à l'aide des lettres "a" à "z" :
Ou par centile, le pourcentage de l'offre de bitcoins qui a été ou sera émis lors de leur minage :
JSON API
Vous pouvez exécuter ord avec l'option --enable-json-api pour accéder à des endpoints qui renvoient du JSON au lieu du HTML si vous définissez le HTTP Accept : application/json header. La structure de ces objets suit de près ce qui est montré dans le HTML. Ces points d'accès sont les suivants :
/inscription/<INSCRIPTION_ID>/inscriptions/inscriptions/block/<BLOCK_HEIGHT>/inscriptions/block/<BLOCK_HEIGHT>/<PAGE_INDEX>/inscriptions/<FROM>/inscriptions/<FROM>/<N>/output/<OUTPOINT>/output/<OUTPOINT>/sat/<SAT>
Pour obtenir une liste des 100 dernières inscriptions, il faut procéder comme suit :
curl -s -H "Accept: application/json" 'http://0.0.0.0:80/inscriptions'Pour obtenir des informations sur un UTXO, qui contient des inscriptions, procédez comme suit :
curl -s -H "Accept: application/json" 'http://0.0.0.0:80/output/bc4c30829a9564c0d58e6287195622b53ced54a25711d1b86be7cd3a70ef61ed:0'
Ce qui retourne:
{
"value": 10000,
"script_pubkey": "OP_PUSHNUM_1 OP_PUSHBYTES_32 156cc4878306157720607cdcb4b32afa4cc6853868458d7258b907112e5a434b",
"address": "bc1pz4kvfpurqc2hwgrq0nwtfve2lfxvdpfcdpzc6ujchyr3ztj6gd9sfr6ayf",
"transaction": "bc4c30829a9564c0d58e6287195622b53ced54a25711d1b86be7cd3a70ef61ed",
"sat_ranges": null,
"inscriptions": [
"6fb976ab49dcec017f1e201e84395983204ae1a7c2abf7ced0a85d692e442799i0"
]
}
7.2 Inscriptions
Guide d'inscription ordinale
Les sats individuels peuvent être inscrits avec un contenu arbitraire, créant ainsi des artefacts numériques compatibles avec Bitcoin qui peuvent être conservés dans un portefeuille Bitcoin et transférés par le biais de transactions Bitcoin. Les inscriptions sont aussi durables, immuables, sûres et décentralisées que Bitcoin lui-même.
Travailler avec des inscriptions nécessite une full node Bitcoin, pour vous donner une vue de l'état actuel de la blockchain Bitcoin, et un portefeuille qui peut créer des inscriptions et effectuer un contrôle sat lors de la construction de transactions pour envoyer des inscriptions à un autre portefeuille.
Bitcoin Core fournit à la fois un nœud complet et un portefeuille Bitcoin. Cependant, le portefeuille Bitcoin Core ne peut pas créer d'inscriptions et n'effectue pas de contrôle de sat.
Ceci nécessite ord, l'utilitaire ordinal. ord n'implémente pas son propre portefeuille, donc les sous-commandes du portefeuille ord interagissent avec les portefeuilles Bitcoin Core.
Ce guide couvre les points suivants :
- L'installation de Bitcoin Core
- La synchronisation de la blockchain Bitcoin
- Créer un portefeuille Bitcoin Core
- Utiliser ord wallet receive pour recevoir des sats
- Créer des inscriptions avec ord wallet inscribe
- Envoyer des inscriptions avec ord wallet send
- Réception d'inscriptions avec ord wallet receive
Obtenir de l'aide
Si vous êtes bloqué, essayez de demander de l'aide sur le serveur Discord d'Ordinals, ou consultez GitHub pour des issues et des discussions pertinentes.
Installer Bitcoin Core
Bitcoin Core est disponible sur bitcoincore.org sur la page de téléchargement.
Faire des inscriptions nécessite Bitcoin Core 24 ou une version plus récente.
Ce guide ne couvre pas l'installation de Bitcoin Core en détail. Une fois Bitcoin Core installé, vous devriez être en mesure d'exécuter bitcoind -version avec succès depuis la ligne de commande.
Configuration de Bitcoin Core
ord nécessite l'index des transactions de Bitcoin Core.
Pour configurer votre node Bitcoin Core afin de maintenir un index des transactions, ajoutez ce qui suit à votre fichier bitcoin.conf :
txindex=1
Ou bien, exécutez bitcoind avec -txindex :
bitcoind -txindex
Synchronisation de la blockchain Bitcoin
Pour synchroniser la blockchain, exécutez la commande suivante
bitcoind -txindex
...et laissez-le tourner jusqu'à ce que getblockcount:
bitcoin-cli getblockcount
corresponde au nombre de blocs sur un exploreur de blocs tel que mempool.space. ord interagit avec bitcoind, vous devez donc laisser bitcoind tourner en arrière-plan lorsque vous utilisez ord.
Troubleshooting
Assurez-vous que vous pouvez accéder à bitcoind avec bitcoin-cli -getinfo et qu'il est entièrement synchronisé.
Si bitcoin-cli -getinfo renvoie "Impossible de se connecter au serveur", c'est que bitcoind ne fonctionne pas.
Assurez-vous que rpcuser, rpcpassword, ou rpcauth ne sont PAS définis dans votre fichier bitcoin.conf. ord nécessite l'utilisation de l'authentification par cookie. Assurez-vous qu'il y a un fichier .cookie dans votre répertoire de données bitcoin.
Si bitcoin-cli -getinfo renvoie Could not locate RPC credentials, vous devez alors spécifier l'emplacement du fichier cookie. Si vous utilisez un répertoire de données personnalisé (en spécifiant l'option datadir), vous devez spécifier l'emplacement du cookie comme bitcoin-cli -rpccookiefile=<your_bitcoin_datadir>/.cookie -getinfo. Lorsque vous exécutez ord, vous devez spécifier l'emplacement du fichier cookie avec --cookie-file=<your_bitcoin_datadir>/.cookie..
Assurez-vous que vous n'avez PAS disablewallet=1 dans votre fichier bitcoin.conf. Si bitcoin-cli listwallets renvoie Method not found le portefeuille est désactivé et vous ne pourrez pas utiliser ord.
Assurez-vous que txindex=1 est défini. Lancez bitcoin-cli getindexinfo et il devrait retourner quelque chose comme
{
"txindex" : {
"synced" : true,
"best_block_height" : 776546
}
}
S'il ne renvoie que {}, le txindex n'est pas défini. S'il renvoie "synced": false, bitcoind est encore en train de créer le txindex. Attendez "synced": true avant d'utiliser ord.
Si vous avez défini maxuploadtarget, cela peut interférer avec la récupération des blocs pour l'index ord. Supprimez-le ou définissez whitebind=127.0.0.1:8333.
Installation de ord
L'utilitaire ord est écrit en Rust et peut être compilé à partir des sources. Des binaires préconstruits sont disponibles sur la page des versions.
Vous pouvez installer le dernier binaire préconstruit à partir de la ligne de commande avec :
curl --proto '=https' --tlsv1.2 -fsLS https://ordinals.com/install.sh | bash -s
Une fois ord installé, vous devriez être en mesure d'exécuter :
ord --version
qui affiche le numéro de version de ord.
Création d'un portefeuille Bitcoin Core
ord utilise Bitcoin Core pour gérer les clés privées, signer les transactions et les diffuser sur le réseau Bitcoin.
Pour créer un portefeuille Bitcoin Core nommé ord pour l'utiliser avec ord, exécutez :
ord wallet create
Recevoir des sats
Les inscriptions sont faites sur des sats individuels, en utilisant des transactions Bitcoin normales qui paient des frais en sats, votre portefeuille aura donc besoin de sats.
Obtenez une nouvelle adresse à partir de votre ord wallet en exécutant :
ord wallet receive
Et envoyez-lui des fonds.
Vous pouvez voir les transactions en cours avec :
ord wallet transactions
Une fois la transaction confirmée, vous devriez être en mesure de voir les résultats des transactions avec ord wallet outputs.
Créer un contenu d'inscription
Les Sats peuvent être inscrits avec n'importe quel type de contenu, mais l'ord wallet ne prend en charge que les types de contenu qui peuvent être affichés par l'explorateur de blocs ord.
En outre, les inscriptions sont incluses dans les transactions, donc plus le contenu est important, plus les frais de la transaction d'inscription doivent être élevés.
Le contenu des inscriptions est inclus dans les témoins de transaction, qui bénéficient de la réduction accordée aux témoins. Pour calculer la taxe approximative qu'une transaction d'inscription devra payer, divisez la taille du contenu par quatre et multipliez par le taux de frais.
Les transactions d'inscription doivent être inférieures à 400 000 unités de poids, sinon elles ne seront pas relayées par Bitcoin Core. Un octet de contenu d'inscription coûte une unité de poids. Étant donné qu'une transaction d'inscription ne comprend pas seulement le contenu de l'inscription, il convient de limiter le contenu de l'inscription à moins de 400 000 unités de poids. 390 000 unités de poids devraient être suffisantes.
Création d'inscriptions
Pour créer une inscription avec le contenu de FICHIER, exécutez :
ord wallet inscribe --fee-rate FEE_RATE FILE
Ord produira deux identifiants de transaction, l'un pour la transaction de validation et l'autre pour la transaction de révélation, ainsi que l'identifiant d'inscription. Les identifiants d'inscription sont de la forme TXIDiN, où TXID est l'identifiant de transaction de la transaction de révélation, et N est l'index de l'inscription dans la transaction de révélation.
La transaction de validation s'engage sur un tapscript contenant le contenu de l'inscription, et la transaction de révélation dépense à partir de ce tapscript, révélant le contenu sur la chaîne et l'inscrivant sur le premier sat de l'entrée qui contient le tapscript correspondant.
Attendez que la transaction de révélation soit minée. Vous pouvez vérifier le statut des transactions commit et reveal en utilisant l'exploreur de blocs mempool.space.
Une fois que la transaction révélée a été minée, l'identifiant de l'inscription devrait être imprimé lors de l'exécution :
ord wallet inscriptions
Et lorsque vous visitez l'exploreur d'ordinals à ordinals.com/inscription/INSCRIPTION_ID.
Inscriptions Parent-Enfant
Les inscriptions parent-enfant permettent ce que l'on appelle familièrement des collections, voir provenance pour plus d'informations.
Pour qu'une inscription devienne l'enfant d'une autre, l'inscription parente doit être inscrite et présente dans le portefeuille. Pour choisir un parent, lancez la commande inscriptions du portefeuille et copiez l'identifiant de l'inscription (<PARENT_INSCRIPTION_ID>).
Inscrivez maintenant l'inscription de l'enfant et spécifiez le parent comme suit :
ord wallet inscribe --fee-rate FEE_RATE --parent <PARENT_INSCRIPTION_ID> CHILD_FILE
Cette relation ne peut pas être ajoutée rétroactivement, le parent doit être présent lors de la création de l'enfant.
Envoi d'inscriptions
Demandez au destinataire de générer une nouvelle adresse en exécutant :
ord wallet receive
Envoyez l'inscription en exécutant la commande suivante
ord wallet send --fee-rate <FEE_RATE> <ADDRESS> <INSCRIPTION_ID>
Voir la transaction en cours avec :
ord wallet transactions
Une fois que la transaction d'envoi est confirmée, le destinataire peut confirmer la réception en lançant : ord wallet inscriptions
ord wallet inscriptions
Réception des inscriptions
Générer une nouvelle adresse de réception en utilisant :
ord wallet receive
L'expéditeur peut transférer l'inscription à votre adresse en utilisant :
ord wallet send ADDRESS INSCRIPTION_ID
Voir la transaction en cours avec :
ord wallet transactions
Une fois que la transaction d'envoi est confirmée, vous pouvez confirmer la réception en exécutant :
ord wallet inscriptions
7.3 Chasse au Sat
Ce guide n'est plus à jour. Depuis qu'il a été écrit, le binaire ord a été modifié pour ne construire l'index complet des satoshi que lorsque l'option --index-sats est fournie. De plus, ord a maintenant un portefeuille intégré qui encapsule un portefeuille Bitcoin Core. Voir ord wallet --help.
La chasse au sat est difficile mais gratifiante. Le sentiment d'avoir un portefeuille rempli d'UTXO, imprégné de l'odeur de sats rares et exotiques, est incomparable.
Les ordinaux sont des nombres pour les satoshis. Chaque satoshi a un numéro ordinal et chaque numéro ordinal a un satoshi.
Préparation
Vous aurez besoin de quelques éléments avant de commencer.
1. Tout d'abord, vous aurez besoin d'une node Bitcoin Core synchronisée avec un index de transaction. Pour activer l'indexation des transactions, passez -txindex sur la ligne de commande :
bitcoind -txindex
Vous pouvez également ajouter ce qui suit à votre fichier de configuration Bitcoin :
txindex=1
Lancez le logiciel et attendez qu'il rattrape le bout de la chaîne. La commande suivante devrait alors vous indiquer la hauteur du bloc actuel :
bitcoin-cli getblockcount
2. Deuxièmement, vous aurez besoin d'un index ord synchronisé.
- Obtenez une copie de ord depuis le repo.
- Exécutez RUST_LOG=info ord index. Il devrait se connecter à votre nœud bitcoin core et commencer l'indexation.
- Attendez que l'indexation soit terminée.
3. Troisièmement, vous aurez besoin d'un portefeuille avec des UTXOs que vous voulez rechercher.
Chercher les Ordinaux rares
Chercher les Ordinaux rares dans un wallet Bitcoin
La commande ord wallet est juste une enveloppe autour de l'API RPC de Bitcoin Core, donc la recherche d'ordinaux rares dans un portefeuille Bitcoin Core est facile. En supposant que votre portefeuille s'appelle foo :
1. Chargez votre portefeuille :
bitcoin-cli loadwallet foo
2. Affichez tous les ordinaux rares des UTXOs du portefeuille foo :
ord wallet sats
Chercher les Ordinaux rares dans un wallet non Bitcoin Core
La commande ord wallet est juste une enveloppe autour de l'API RPC de Bitcoin Core, donc pour rechercher des ordinaux rares dans un portefeuille non-Bitcoin Core, vous devrez importer les descripteurs de votre portefeuille dans Bitcoin Core.
Les descripteurs décrivent la façon dont les portefeuilles génèrent les clés privées et les clés publiques.
Vous ne devez importer dans Bitcoin Core que les descripteurs des clés publiques de votre portefeuille, et non ceux de ses clés privées.
Si le descripteur de la clé publique de votre portefeuille est compromis, un hacker pourra voir les adresses de votre portefeuille, mais vos fonds seront en sécurité.
Si le descripteur de la clé privée de votre portefeuille est compromis, un hacker peut vider votre portefeuille de ses fonds.
1. Obtenez le descripteur du portefeuille dont vous voulez rechercher les UTXOs pour les ordinaux rares. Il ressemblera à quelque chose comme ceci :
wpkh([bf1dd55e/84'/0'/0']xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YGDonYySij4XTawL6iNZvmZwdnSEEep/0/*)#csvefu29
2. Créer un portefeuille watch-only nommé foo-watch-only :
bitcoin-cli createwallet foo-watch-only true true
N'hésitez pas à lui donner un meilleur nom que foo-watch-only !
3. Chargez le portefeuille foo-watch-only :
bitcoin-cli loadwallet foo-watch-only
4. Importez les descripteurs de votre portefeuille dans foo-watch-only :
bitcoin-cli importdescriptors \N
'[{"desc" : "wpkh([bf1dd55e/84h/0h/0h]xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YGDonYySij4XTawL6iNZvmZwdnSEEep/0/*)#tpnxnxax", "timestamp":0 }]''.
Si vous connaissez la date Unix à laquelle votre portefeuille a commencé à recevoir des transactions, vous pouvez l'utiliser comme valeur de "timestamp" au lieu de 0. Cela réduira le temps nécessaire à Bitcoin Core pour rechercher les UTXO de votre portefeuille.
5. Vérifiez que tout a fonctionné :
bitcoin-cli getwalletinfo
6.Affichez les ordinaux rares de votre portefeuille :
ord wallet sats
Recherche d'ordinaux rares dans un portefeuille qui exporte des descripteurs de chemins multiples
Certains descripteurs décrivent plusieurs chemins dans un seul descripteur en utilisant des crochets, par exemple, <0;1>. Les descripteurs à chemins multiples ne sont pas encore pris en charge par Bitcoin Core, vous devrez donc d'abord les convertir en descripteurs multiples, puis importer ces descripteurs multiples dans Bitcoin Core.
1. Tout d'abord, récupérez le descripteur de chemin multiple de votre portefeuille. Il ressemblera à quelque chose comme ceci :
wpkh([bf1dd55e/84h/0h/0h]xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/<0;1>/*)#fw76ulgt
2. Créer un descripteur pour le chemin d'adresse de réception :
wpkh([bf1dd55e/84'/0'/0']xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/0/*)
Et le chemin de changement d'adresse:
wpkh([bf1dd55e/84'/0'/0']xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/1/*)
3. Obtenir et noter la somme de contrôle du descripteur d'adresse de réception, dans ce cas tpnxnxax :
bitcoin-cli getdescriptorinfo \
'wpkh([bf1dd55e/84h/0h/0h]xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/0/*)'
{
"descriptor": "wpkh([bf1dd55e/84'/0'/0']xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/0/*)#csvefu29",
"checksum": "tpnxnxax",
"isrange": true,
"issolvable": true,
"hasprivatekeys": false
}
Et pour le descripteur de changement d'adresse, dans ce cas 64k8wnd7 :
bitcoin-cli getdescriptorinfo \
'wpkh([bf1dd55e/84h/0h/0h]xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/1/*)'
{
"descriptor": "wpkh([bf1dd55e/84'/0'/0']xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/1/*)#fyfc5f6a",
"checksum": "64k8wnd7",
"isrange": true,
"issolvable": true,
"hasprivatekeys": false
}
4. Chargez le portefeuille dans lequel vous souhaitez importer les descripteurs :
bitcoin-cli loadwallet foo-watch-only
5. Importez maintenant les descripteurs, avec les sommes de contrôle correctes, dans Bitcoin Core.
bitcoin-cli \
importdescriptors \
'[
{
"desc": "wpkh([bf1dd55e/84h/0h/0h]xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/0/*)#tpnxnxax"
"timestamp":0
},
{
"desc": "wpkh([bf1dd55e/84h/0h/0h]xpub6CcJtWcvFQaMo39ANFi1MyXkEXM8T8ZhnxMtSjQAdPmVSTHYnc8Hwoc11VpuP8cb8JUTboZB5A7YYGDonYySij4XTawL6iNZvmZwdnSEEep/1/*)#64k8wnd7",
"timestamp":0
}
]'
Si vous connaissez la date Unix à laquelle votre portefeuille a commencé à recevoir des transactions, vous pouvez l'utiliser pour la valeur du champ "timestamp" au lieu de 0. Cela réduira le temps nécessaire à Bitcoin Core pour rechercher les UTXO de votre portefeuille.
6. Vérifiez que tout a fonctionné :
bitcoin-cli getwalletinfo
7. Affichez les ordinaux rares de votre portefeuille :
ord wallet sats
Exporter les descripteurs
Sparrow Wallet
Naviguez jusqu'à l'onglet Paramètres, puis jusqu'à Script Policy, et appuyez sur le bouton d'édition pour afficher le descripteur.
Transférer des ordinaux
Le portefeuille ord permet de transférer des satoshis spécifiques. Vous pouvez également utiliser les commandes bitcoin-cli createrawtransaction, signrawtransactionwithwallet et sendrawtransaction. La manière de procéder est complexe et sort du cadre de ce guide.
7.4 Collectionner
Actuellement, ord est le seul portefeuille qui supporte le contrôle et la sélection de sat, qui sont nécessaires pour stocker et envoyer en toute sécurité des sats et des inscriptions rares, ci-après dénommés ordinaux.
Il est recommandé d'envoyer, de recevoir et de stocker les ordinaux avec ord, mais si vous êtes prudent, il est possible de stocker, et dans certains cas d'envoyer, des ordinaux en toute sécurité avec d'autres portefeuilles.
D'une manière générale, il n'est pas dangereux de recevoir des ordinaux dans un portefeuille non pris en charge. Les ordinaux peuvent être envoyés à n'importe quelle adresse bitcoin et sont sûrs tant que l'UTXO qui les contient n'est pas dépensé. Cependant, si ce portefeuille est ensuite utilisé pour envoyer des bitcoins, il peut sélectionner l'UTXO contenant l'ordinal comme entrée, et envoyer l'inscription ou la dépenser pour payer des frais.
Un guide pour la création d'un portefeuille compatible avec les ordinaux avec Sparrow Wallet est disponible dans ce manuel.
Veuillez noter que si vous suivez ce guide, vous ne devez pas utiliser le portefeuille que vous créez pour envoyer des BTC, à moins que vous n'effectuiez une sélection manuelle des pièces pour éviter d'envoyer des ordinaux.
7.4.1 Collecte d'inscriptions et d'ordinaux avec le Sparrow Wallet
Les utilisateurs qui ne peuvent pas ou n'ont pas encore mis en place le portefeuille ord peuvent recevoir des inscriptions et des ordinaux avec d'autres portefeuilles bitcoins, à condition de faire très attention à la manière dont ils dépensent l'argent de ce portefeuille.
Ce guide donne quelques étapes de base sur la façon de créer un portefeuille avec Sparrow Wallet qui est compatible avec ord et qui peut être importé plus tard dans ord.
⚠️⚠️ Attention ! ⚠️⚠️
En règle générale, si vous adoptez cette approche, vous devez utiliser ce portefeuille avec le logiciel Sparrow comme un portefeuille de réception uniquement.
Ne dépensez pas de satoshis à partir de ce portefeuille à moins d'être sûr de savoir ce que vous faites. Vous pourriez très facilement perdre par inadvertance l'accès à vos ordinaux et à vos inscriptions si vous ne tenez pas compte de cet avertissement.
Mise en place du portefeuille et réception
Téléchargez le Sparrow Wallet à partir de la page des versions de votre système d'exploitation.
Sélectionnez Fichier -> Nouveau portefeuille et créez un nouveau portefeuille appelé ord.
Changez le type de script en Taproot (P2TR) et sélectionnez l'option New or Imported Software Wallet (portefeuille de logiciels nouveaux ou importés).
Sélectionnez Utiliser 12 mots, puis cliquez sur Générer nouveau. Laissez la passphrase vide.
Une nouvelle phrase de semence BIP39 de 12 mots sera générée pour vous. Notez-la dans un endroit sûr, car il s'agit de votre moyen de sauvegarde pour accéder à votre portefeuille. Ne partagez JAMAIS cette seed phrase avec quelqu'un d'autre.
Une fois que vous avez noté la phrase d'initialisation, cliquez sur Confirmer la sauvegarde.
Saisissez à nouveau l'expression de départ que vous avez notée, puis cliquez sur Create keystore.
Cliquez Import Keystore.
Cliquez sur Appliquer. Ajoutez un mot de passe pour le portefeuille si vous le souhaitez.
Vous disposez maintenant d'un portefeuille compatible avec ord, qui peut être importé dans ord à l'aide de la Seed Phrase du BIP39. Pour recevoir des ordinaux ou des inscriptions, cliquez sur l'onglet Recevoir et copiez une nouvelle adresse.
Chaque fois que vous voulez recevoir, vous devez utiliser une toute nouvelle adresse et ne pas réutiliser les adresses existantes.
Notez que bitcoin est différent de certains autres portefeuilles de blockchain, en ce sens que ce portefeuille peut générer un nombre illimité de nouvelles adresses. Vous pouvez générer une nouvelle adresse en cliquant sur le bouton Obtenir la prochaine adresse. Vous pouvez voir toutes vos adresses dans l'onglet Adresses de l'application.
Vous pouvez ajouter une étiquette à chaque adresse, afin de savoir à quoi elle a servi.
Validation / Visualisation des inscriptions reçues
Une fois que vous avez reçu une inscription, vous verrez une nouvelle transaction dans l'onglet Transactions de Sparrow, ainsi qu'un nouvel UTXO dans l'onglet UTXOs.
Au départ, cette transaction peut avoir un statut "non confirmé", et vous devrez attendre qu'elle soit minée dans un bloc de bitcoins avant qu'elle ne soit entièrement reçue.
Pour suivre le statut de votre transaction, vous pouvez faire un clic droit sur celle-ci, sélectionner Copier l'identifiant de la transaction et ensuite coller cet identifiant de transaction dans mempool.space.
Une fois la transaction confirmée, vous pouvez valider et visualiser votre inscription en vous rendant dans l'onglet UTXOs, en trouvant l'UTXO que vous souhaitez vérifier, en faisant un clic droit sur la sortie et en sélectionnant Copier la sortie de la transaction. Cet identifiant de sortie de transaction peut ensuite être collé dans la recherche ordinals.com.
Gel des UTXO
Comme nous l'avons expliqué plus haut, chacune de vos inscriptions est stockée dans une sortie de transaction non dépensée (UTXO). Vous devez faire très attention à ne pas dépenser accidentellement vos inscriptions, et une façon de rendre cela plus difficile est de geler l'UTXO.
Pour ce faire, allez dans l'onglet UTXOs, trouvez l'UTXO que vous voulez geler, faites un clic droit sur la sortie et sélectionnez Freeze UTXO.
Cet UTXO (Inscription) ne peut plus être dépensé dans le Portefeuille des moineaux jusqu'à ce que tu le décongèles.
Importation dans ord wallet
Pour plus de détails sur la configuration de Bitcoin Core et de l'ord wallet, consultez le Guide des inscriptions.
Lors de la configuration d'ord, au lieu d'exécuter ord wallet create pour créer un tout nouveau portefeuille, vous pouvez importer votre portefeuille existant en utilisant ord wallet restore "BIP39 SEED PHRASE" en utilisant la phrase de démarrage que vous avez générée avec Sparrow Wallet.
Il y a actuellement un bug qui fait qu'un portefeuille importé n'est pas automatiquement re-scanné par rapport à la blockchain. Pour contourner ce problème, vous devrez déclencher manuellement un rescan à l'aide du clique bitcoin core : bitcoin-cli -rpcwallet=ord rescanblockchain 767430
Vous pouvez ensuite vérifier les inscriptions de votre portefeuille en utilisant ord wallet inscriptions
Notez que si vous avez précédemment créé un portefeuille avec ord, alors vous aurez déjà un portefeuille avec le nom par défaut, et vous devrez donner un nom différent à votre portefeuille importé. Vous pouvez utiliser le paramètre --wallet dans toutes les commandes ord pour référencer un portefeuille différent, par exemple :
ord --wallet ord_from_sparrow wallet restore "BIP39 SEED PHRASE"
ord --wallet ord_from_sparrow wallet inscriptions
bitcoin-cli -rpcwallet=ord_from_sparrow rescanblockchain 767430
Envoyer des inscriptions avec Sparrow Wallet
⚠️⚠️ Avertissement ⚠️⚠️
Bien qu'il soit fortement recommandé de mettre en place un node bitcoin core et d'exécuter le logiciel ord, il existe certaines façons limitées d'envoyer des inscriptions hors de Sparrow Wallet en toute sécurité. Veuillez noter que cela n'est pas recommandé et que vous ne devez le faire que si vous comprenez parfaitement ce que vous faites.
L'utilisation du logiciel ord supprimera une grande partie de la complexité que nous décrivons ici, car il est capable de gérer automatiquement et en toute sécurité l'envoi d'inscriptions d'une manière simple.
⚠️⚠️ Avertissement supplémentaire ⚠️⚠️
N'utilisez pas votre portefeuille sparrow inscriptions pour effectuer des envois généraux de bitcoins sans inscription. Vous pouvez créer un portefeuille séparé dans sparrow si vous avez besoin de faire des transactions bitcoin normales, et garder votre portefeuille d'inscriptions séparé.
Le modèle UTXO de Bitcoin
Avant d'envoyer une transaction, il est important que vous ayez un bon modèle mental du système UTXO (Unspent Transaction Output) de Bitcoin. Le fonctionnement du Bitcoin est fondamentalement différent de celui de nombreuses autres blockchains telles que Ethereum. Dans Ethereum, vous avez généralement une seule adresse dans laquelle vous stockez l'ETH, et vous ne pouvez pas faire de différence entre les ETH - il s'agit simplement d'une valeur unique du montant total dans cette adresse. Bitcoin fonctionne très différemment en ce sens que nous générons une nouvelle adresse dans le portefeuille pour chaque réception, et chaque fois que vous recevez des sats à une adresse dans votre portefeuille, vous créez un nouvel UTXO. Chaque UTXO peut être vu et géré individuellement. Vous pouvez sélectionner des UTXO spécifiques que vous souhaitez dépenser, et vous pouvez choisir de ne pas dépenser certains UTXO.
Certains portefeuilles Bitcoin n'exposent pas ce niveau de détail et se contentent d'afficher la valeur totale de tous les bitcoins qu'ils contiennent. Cependant, lorsque vous envoyez des inscriptions, il est important que vous utilisiez un portefeuille comme Sparrow qui permet de contrôler les UTXO.
Contrôle de l'inscription avant l'envoi
Comme nous l'avons décrit précédemment, les inscriptions sont gravées sur des sats et les sats sont stockés dans des UTXO. Les UTXO sont une collection de satoshis avec une valeur particulière du nombre de satoshis (la valeur de sortie). En général (mais pas toujours), l'inscription est inscrite sur le premier satoshi de l'UTXO.
Lorsque vous inspectez votre inscription avant de l'envoyer, la principale chose que vous voudrez vérifier est le satoshi de l'UTXO sur lequel votre inscription est inscrite.
Pour ce faire, vous pouvez suivre la procédure de validation / visualisation des inscriptions reçues décrite ci-dessus pour trouver la page d'inscription de votre inscription sur ordinals.com.
Vous y trouverez des métadonnées sur votre inscription qui ressemblent à ce qui suit :
Il y a quelques points importants à vérifier ici :
- L'identifiant de sortie correspond à l'identifiant de l'UTXO que vous allez envoyer.
- Le décalage de l'inscription est de 0 (cela signifie que l'inscription est située sur la première sat de l'UTXO)
- La valeur de sortie contient suffisamment de sats pour couvrir les frais de transaction (frais postaux) liés à l'envoi de la transaction. Le montant exact dont vous aurez besoin dépend du taux de frais que vous choisirez pour la transaction.
Si toutes les conditions ci-dessus s'appliquent à votre inscription, vous pouvez l'envoyer en toute sécurité en utilisant la méthode ci-dessous.
⚠️⚠️ Soyez très prudent lorsque vous envoyez votre inscription, en particulier si la valeur du décalage est différente de 0. Il n'est pas recommandé d'utiliser cette méthode si c'est le cas, car vous pourriez accidentellement envoyer votre inscription à un mineur de bitcoins, à moins que vous ne sachiez ce que vous faites.
Envoi de l'inscription
Pour envoyer une inscription, naviguez jusqu'à l'onglet UTXOs, et trouvez l'UTXO que vous avez validé précédemment et qui contient votre inscription.
Si vous avez précédemment gelé l'UTXO, vous devrez faire un clic droit dessus et le dégeler.
Sélectionnez l'UTXO que vous souhaitez envoyer et assurez-vous que c'est le seul UTXO sélectionné. Vous devriez voir les UTXOs 1/1 dans l'interface. Une fois que vous êtes sûr que c'est le cas, vous pouvez cliquer sur Envoyer la sélection.
L'interface de construction de la transaction s'affiche alors. Il y a quelques points que vous devez vérifier ici pour vous assurer que l'envoi est sûr :
La transaction ne doit avoir qu'une seule entrée, qui doit être l'UTXO avec l'étiquette que vous voulez envoyer.
La transaction ne doit avoir qu'une seule sortie, qui est l'adresse/l'étiquette où vous voulez envoyer l'inscription.
Si votre transaction est différente, par exemple si vous avez plusieurs entrées ou plusieurs sorties, il se peut que le transfert de votre inscription ne soit pas sûr et que vous deviez renoncer à l'envoyer jusqu'à ce que vous en sachiez plus ou que vous puissiez l'importer dans le porte-monnaie ord.
Vous devez fixer des frais de transaction appropriés, Sparrow vous en recommandera généralement un raisonnable, mais vous pouvez également consulter mempool.space pour voir quel est le taux de frais recommandé pour l'envoi d'une transaction.
Vous devez ajouter un libellé pour l'adresse du destinataire, un libellé comme l'adresse d'Alice pour l'inscription #123 serait idéal.
Une fois que vous avez vérifié que la transaction est sûre en utilisant les contrôles ci-dessus, et que vous êtes confiant pour l'envoyer, vous pouvez cliquer sur Créer une transaction.
Ici encore, vous pouvez vérifier que votre transaction semble sûre et, une fois que vous êtes sûr de vous, vous pouvez cliquer sur Finaliser la transaction pour la signer.
Vérifiez tout une nouvelle fois avant de cliquer Sign.
Ensuite, vous avez une toute dernière chance de tout vérifier avant de lancer la diffusion de la transaction. Une fois la transaction diffusée, elle est envoyée au réseau bitcoin et commence à se propager dans le pool de mémoire.
Si vous souhaitez suivre l'état de votre transaction, vous pouvez copier l'identifiant de la transaction (Txid) et le coller dans mempool.space.
Une fois la transaction confirmée, vous pouvez consulter la page d'inscription sur ordinals.com pour vérifier qu'elle a bien été transférée vers le nouveau lieu et la nouvelle adresse de sortie.
Debuggage
Le portefeuille Sparrow n'affiche pas de transaction/UTXO, mais je peux la voir sur mempool.space !
Assurez-vous que votre portefeuille est connecté à un nœud bitcoin. Pour valider cela, allez dans les Préférences-> Paramètres du serveur, et cliquez sur Modifier la connexion existante.
De là, vous pouvez sélectionner un node et cliquer sur Test Connection pour valider que Sparrow est capable de se connecter avec succès.
7.5 Testing
Ord peut être testé en utilisant les drapeaux suivants pour spécifier le réseau de test. Pour plus d'informations sur l'exécution de Bitcoin Core pour les tests, voir la documentation du développeur de Bitcoin.
La plupart des commandes dans les inscriptions et l'exploreur peuvent être exécutées avec les drapeaux de réseau suivants :
Testnet --testnet ou -t
Signet --signet ou -s
Regtest --regtest ou -r
Regtest ne nécessite pas de télécharger la blockchain ou d'indexer ord.
Exemple
Exécuter bitcoind dans regtest avec :
bitcoind -regtest -txindex
Créer un portefeuille dans regtest avec :
ord -r wallet create
Obtenir une adresse de réception de regtest avec :
ord -r wallet receive
Miner 101 blocs (pour débloquer la coinbase) avec :
bitcoin-cli -regtest generatetoaddress 101 <receive address>
Inscrire dans regtset avec :
ord -r wallet inscribe --fee-rate 1 <file>
Miner l'inscription avec:
bitcoin-cli -regtest generatetoaddress 1 <receive address>
Voir l'inscription dans le regtest exploreur :
ord -r server
Tester la récursion
Lorsque vous testez la récursion, inscrivez d'abord les dépendances (exemple avec p5.js) :
ord -r wallet inscribe --fee-rate 1 p5.js
Cela devrait retourner un inscription_id que vous pouvez ensuite référencer dans votre inscription récursive.
ATTENTION : Ces ids seront différents si vous inscrivez sur mainnet ou signet, donc assurez-vous de les changer dans votre inscription récursive pour chaque chaîne.
Vous pouvez ensuite inscrire votre inscription récursive avec :
ord -r wallet inscribe --fee-rate 1 recursive-inscription.html
Enfin, vous devrez miner quelques blocs et démarrer le serveur :
bitcoin-cli generatetoaddress 6 <receive address>
ord -r server
7.6 Modération
ord comprend un exploreur de blocs, que vous pouvez exécuter localement avec le serveur ord.
L'exploreur de blocs permet de visualiser les inscriptions. Les inscriptions sont des contenus générés par les utilisateurs, qui peuvent être répréhensibles ou illégaux.
Il incombe à chaque personne qui gère une instance de l'explorateur de blocs ordinal de comprendre ses responsabilités en matière de contenu illicite et de décider de la politique de modération appropriée pour son instance.
Afin d'empêcher l'affichage d'inscriptions particulières sur une instance ord, celles-ci peuvent être incluses dans un fichier de configuration YAML, qui est chargé avec l'option --config.
Pour masquer des inscriptions, créez d'abord un fichier de configuration, avec l'identifiant de l'inscription que vous souhaitez masquer :
hidden :
- 0000000000000000000000000000000000000000000000000000000000000000i0
Le nom suggéré pour les fichiers de configuration ord est ord.yaml, mais n'importe quel nom de fichier peut être utilisé.
Passez ensuite le fichier à --config lors du démarrage du serveur :
ord --config ord.yaml server
Notez que l'option --config vient après ord mais avant la sous-commande server.
ord doit être redémarré pour prendre en compte les modifications apportées au fichier de configuration.
ordinals.com
Les instances de ordinals.com utilisent systemd pour exécuter le service de serveur ord, appelé ord, avec un fichier de configuration situé dans /var/lib/ord/ord.yaml.
Pour masquer une inscription sur ordinals.com :
- Se connecter en SSH au serveur
- Ajoutez l'identifiant de l'inscription à /var/lib/ord/ord.yaml
- Redémarrez le service avec systemctl restart ord
- Surveiller le redémarrage avec journalctl -u ord
Actuellement, ord est lent à redémarrer, le site ne sera donc pas remis en ligne immédiatement.
7.7 Réindexer
Parfois, la base de données ord doit être réindexée, ce qui signifie qu'il faut supprimer la base de données et relancer le processus d'indexation avec ord index update ou ord server. Les raisons de réindexer sont les suivantes
- Une nouvelle version majeure de ord, qui modifie le schéma de la base de données
- La base de données a été corrompue d'une manière ou d'une autre
La base de données utilisée par ord s'appelle redb, c'est pourquoi nous donnons à l'index le nom de fichier par défaut index.redb. Par défaut, nous stockons ce fichier à différents endroits en fonction de votre système d'exploitation.
| Plateforme | Valeur | Exemple | |
| Linux | $XDG_DATA_HOME/ord or $HOME/.local/share/ord |
/home/alice/.local/share/ord | |
| macOS | $HOME/Library/Application Support/ord |
/Users/Alice/Library/Application Support/ord | |
| Windows | {FOLDERID_RoamingAppData}\ord |
|
Ainsi, pour supprimer la base de données et la réindexer sur MacOS, vous devez exécuter les commandes suivantes dans le terminal :
rm ~/Library/Application Support/ord/index.redb
ord index update
Vous pouvez bien sûr définir vous-même l'emplacement du répertoire de données avec ord --data-dir <DIR> index update ou lui donner un nom de fichier et un chemin spécifiques avec ord --index <FILENAME> index update.
Commentaires
0 commentaire
Vous devez vous connecter pour laisser un commentaire.