JSON-RPC Bitcoin compatibles avec Amazon Managed Blockchain (AMB) Access Bitcoin

Cette rubrique fournit une liste et des références aux Bitcoin JSON-RPC pris en charge par Managed Blockchain. Chaque JSON-RPC pris en charge est accompagné d'une brève description de son utilisation.

Note

• Vous pouvez authentifier les Bitcoin JSON-RPC sur Managed Blockchain en utilisant le processus de signature Signature Version 4 (SigV4). Cela signifie que seuls les principaux IAM autorisés du AWS compte peuvent interagir avec celui-ci en utilisant les Bitcoin JSON-RPC. Fournissez des AWS informations d'identification (un identifiant de clé d'accès et une clé d'accès secrète) avec l'appel.

• Si votre réponse HTTP est supérieure à 10 Mo, un message d'erreur s'affichera. Pour corriger cela, vous devez définir les en-têtes de compression surAccept-Encoding:gzip. La réponse compressée que votre client reçoit ensuite contient les en-têtes suivants : Content-Type: application/json etContent-Encoding: gzip.

• Amazon Managed Blockchain (AMB) Access Bitcoin génère une erreur 400 pour les requêtes JSON-RPC mal formées.

• Utilisez le sendrawtransaction JSON-RPC pour soumettre des transactions qui mettent à jour l'état de la blockchain Bitcoin.

• AMB Access Bitcoin a une limite de demandes par défaut de 100 demandes par seconde (RPS)NETWORK_TYPE, par région. AWS

  Pour augmenter votre quota, vous devez contacter le AWS support. Pour contacter le AWS support, connectez-vous à la console du centre de AWS support. Choisissez Create case (Créer une demande). Choisissez Technique. Choisissez Managed Blockchain comme service. Choisissez Access:Bitcoin comme catégorie et General Guidance comme niveau de gravité. Entrez RPC Quota comme sujet et dans la zone de texte Description et listez les limites de quota applicables à vos besoins en RPS par réseau Bitcoin et par région. Soumettez votre dossier.

JSON-RPC pris en charge

AMB Access Bitcoin prend en charge les Bitcoin JSON-RPC suivants. Chaque appel pris en charge est accompagné d'une brève description de son utilisation.

Catégorie	JSON-RPC	Description
RPC Blockchain	getbestblockhash	Renvoie le hachage du meilleur bloc (pointe) de la chaîne entièrement validée la plus travaillée.
	getblock	Si la verbosité est égale à 0, renvoie une chaîne sérialisée contenant des données codées en hexadécimal pour le « hachage » du bloc. Si la verbosité est égale à 1, renvoie un objet contenant des informations sur le « hachage » du bloc. Si la verbosité est égale à 2, renvoie un objet contenant des informations sur le « hachage » du bloc et des informations sur chaque transaction. Si la verbosité est égale à 3, renvoie un objet contenant des informations sur le « hachage » du bloc et des informations sur chaque transaction, y compris les prevout informations pour les entrées.
	obtenir des informations sur la blockchain	Renvoie un objet contenant diverses informations d'état concernant le traitement de la blockchain.
	obtenir le nombre de blocs	Renvoie la hauteur de la chaîne entièrement validée la plus travaillée. Le bloc de genèse a une hauteur de 0.
	filtre getblock	Récupère un filtre de contenu BIP 157 pour un bloc particulier à l'aide du hachage du bloc.
	getblockhash	Renvoie le hachage du bloc best-block-chain à la hauteur fournie.
	getblockheader	Si verbose est faux, renvoie une chaîne sérialisée contenant des données codées en hexadécimal pour le « hachage » de l'en-tête de bloc. Si verbose est vrai, renvoie un objet contenant des informations sur le blockheader 'hash'.
	obtenir des statistiques sur les blocs	Calcule les statistiques par bloc pour une fenêtre donnée. Tous les montants sont en satoshis. Cela ne fonctionnera pas sur certaines hauteurs avec l'élagage.
	obtenir des conseils sur les chaînes	Renvoie des informations sur toutes les pointes connues de l'arbre à blocs, y compris la chaîne principale et les branches orphelines.
	getchaintxstats	Calcule des statistiques sur le nombre total et le taux de transactions dans la chaîne.
	avoir de la difficulté	Renvoie la proof-of-work difficulté sous la forme d'un multiple de la difficulté minimale.
	découvrez les ancêtres de Mempool	Si txid se trouve dans le mempool, renvoie tous les ancêtres du mempool.
	obtenir des descendants de mempool	Si txid se trouve dans le mempool, renvoie tous les descendants du mempool.
	getmempool entry	Renvoie les données mempool pour une transaction donnée.
	obtenir des informations sur Mempool	Renvoie des informations sur l'état actif du pool de mémoire TX.
	getrawmempool	Renvoie tous les identifiants de transaction du pool de mémoire sous la forme d'un tableau JSON d'identifiants de transaction sous forme de chaîne. Note verbose = true n’est pas pris en charge.
	sortir	Renvoie les détails d'une sortie de transaction non dépensée.
	gettxoutproof	Renvoie une preuve codée en hexadécimal indiquant que « txid » a été inclus dans un bloc.
RPC de transactions brutes	créer une transaction brute	Crée une transaction dépensant les entrées données et créant de nouvelles sorties.
	décoder une transaction brute	Renvoie un objet JSON représentant la transaction sérialisée codée en hexadécimal.
	décodécrire	Décode un script codé en hexadécimal.
	transaction getraw	Renvoie les données de transaction brutes.
	envoyer une transaction brute	Soumet une transaction brute (sérialisée, codée en hexadécimal) au nœud et au réseau locaux.
	testez mempool accept	Renvoie le résultat des tests d'acceptation de mempool indiquant si la transaction brute (sérialisée, codée en hexadécimal) serait acceptée par mempool. Cela permet de vérifier si la transaction enfreint les règles de consensus ou de politique.
Util RPC	créer un multisig	Crée une adresse multisignature avec aucune signature de mes clés requise.
	estimer les frais intelligents	Estime les frais approximatifs par kilo-octet requis pour qu'une transaction commence à être confirmée dans les blocs conf_target, si possible, et renvoie le nombre de blocs pour lesquels l'estimation est valide. Utilise la taille de transaction virtuelle, telle que définie dans le BIP 141 (les données des témoins sont réduites).
	valider l'adresse	Renvoie des informations sur l'adresse bitcoin donnée.
	vérifier le message	Vérifie un message signé.