Carica un manifesto contratto nel registro

È possibile utilizzare Blockchain App Builder per convalidare e pubblicare i metadati di distribuzione da un progetto Hardhat selezionato ai servizi del registro dei contratti.

Lo strumento Carica file manifesto contratto esegue il plugin hardhat-upload-contract-artefacts di proprietà del progetto e passa gli endpoint del registro come valori runtime; non modifica le variabili Hardhat del progetto.

Il caricamento del file manifesto è disponibile solo per gli ambienti Besu di Oracle Blockchain Platform salvati.

Prerequisiti

  • Selezionare un progetto Hardhat importato o composto distribuito correttamente.
  • Confermare che il progetto include il pacchetto hardhat-upload-contract-artefacts nel file package.json, importare il plugin in hardhat.config.ts o hardhat.config.js e definire la configurazione uploadContractManifest.
  • Creare o selezionare un ambiente Besu di Oracle Blockchain Platform con l'ID catena e l'autenticazione proxy RPC corretti.
  • Assicurarsi che i record di distribuzione locale richiesti esistano per la modalità di caricamento scelta.

Sono supportate le seguenti modalità di caricamento.

Modalità caricamento Record locali obbligatori Destinazione registro
Entrambi File manifesto OpenZeppelin, JSON di contratti distribuiti ERC-7201 e JSON di contratti distribuiti SOLC Entrambi gli endpoint del registro
ERC-7201 / Aggiornabile File manifesto OpenZeppelin e JSON dei contratti distribuiti ERC-7201 Endpoint registro ERC-7201
Immutabile / SOLC JSON dei contratti distribuiti SOLC Endpoint registro SOLC

Per un progetto importato preconfezionato o contratti di asset digitali generati da Blockchain App Builder, in genere la modalità ERC-7201 è sufficiente.

Per l'ID catena 1500, i percorsi predefiniti sono i seguenti.
./.openzeppelin/unknown-1500.json
./.obp-da/.erc7201/deployedContracts-1500.json
./.obp-da/.solc/deployedContracts-1500.json
Modificare i percorsi se il progetto memorizza i record di distribuzione altrove.
  1. Aprire Strumenti per sviluppatori, quindi selezionare Carica manifesto contratto.
  2. Selezionare il progetto Hardhat e un ambiente Oracle Blockchain Platform Besu.
  3. Selezionare la modalità di caricamento.
  4. Immettere l'URL o gli URL dell'endpoint del registro richiesti:
    • Endpoint registro caricamento file manifesto ERC-7201 per i record aggiornabili
    • Endpoint registro caricamento manifesto SOLC per i record immutabili
    .
  5. Confermare i percorsi dei file OpenZeppelin e del contratto distribuito. Facoltativamente, impostare il timeout e l'output descrittivo.
  6. Selezionare Convalida. Il plugin viene eseguito e non pubblica i dati del registro.
  7. Quando la convalida riesce, deselezionare Convalida e selezionare Carica.

Risoluzione dei problemi

Condizione Risoluzione
Nessun ambiente disponibile Creare un ambiente Oracle Blockchain Platform Besu salvato. Le VM e il nodo locale Hardhat non sono ambienti validi per il caricamento dei file manifesto.
Endpoint del registro non valido Immettere un URL di registro HTTP o HTTPS completo per ogni endpoint richiesto dalla modalità selezionata.
File richiesto non trovato Compilare e distribuire i contratti pertinenti o correggere il file manifesto relativo al progetto e il percorso del file del contratto distribuito.
Plugin o configurazione mancanti Installare o importare hardhat-upload-contract-artefacts e aggiungere la configurazione uploadContractManifest mostrata nella guida preliminare dello strumento.
Caricamento non riuscito dopo esecuzione manuale riuscita Rivedere l'autenticazione del registro-servizio, la disponibilità, i criteri degli endpoint e l'output completo del plugin. L'esecuzione manuale convalida gli input locali, ma non garantisce l'accettazione del registro.