Cardano Technical Workshop

Workbench de transações Cardano

Construa, assine, inspecione e submeta transações na Cardano Preprod.

Rede Verificando

Antes de começar

Prepare o ambiente

O frontend chama a API para construir e submeter transações. A credencial Blockfrost fica no backend; a chave privada permanece na wallet CIP-30.

  1. Blockfrost PreprodConfigure BLOCKFROST_PROJECT_ID no ambiente do backend.
  2. Wallet CIP-30Instale e desbloqueie uma extensão compatível.
  3. Wallet em testnetSelecione Preprod na extensão antes de conectar.
  4. Saldo de tADAA wallet precisa de ao menos um UTxO na Preprod para construir transações.

O identificador CIP-30 confirma testnet, mas não distingue Preprod de Preview. Confira o nome da rede na extensão. Sem saldo, copie seu addr_test, abra o faucet oficial, selecione Pre-production e solicite test ada. Depois, reconecte para repetir a verificação.

Nenhuma wallet conectada.

Verificando o ambiente...

Exercício 1

Pagamento simples

Envie tADA e acompanhe o corpo sem assinatura, o witness, a transação assinada e a inclusão em bloco.

Objetivo

Enviar uma quantidade definida de lovelace para outro endereço.

Concluído quando

O hash aparecer como incluído em um bloco da Preprod.

Efeito da submissão

Gasta tADA e taxa da wallet conectada. Depois de incluída, a transferência não pode ser desfeita.

  1. 1
    ConstruirA API consulta UTxOs e calcula inputs, outputs, taxa e troco.
  2. 2
    AssinarA extensão mostra a transação e produz um witness sem expor a chave.
  3. 3
    AnexarA Workbench valida o witness contra o corpo e cria o signed CBOR.
  4. 4
    SubmeterRevise o efeito e envie a transação assinada à Preprod.
  5. 5
    ConfirmarVerifique se o hash foi incluído em um bloco.

Revisão antes da submissão

Construa e assine a transação para ver o resumo.

Exercício 2

Pagamento com metadata

Envie tADA e publique uma mensagem no label 674 na mesma transação.

Objetivo

Relacionar uma mensagem pública a uma transação de pagamento.

Concluído quando

A transação estiver incluída e o label 674 puder ser inspecionado.

Efeito da submissão

Transfere tADA e publica a mensagem permanentemente. Não use dados pessoais ou sigilosos.

  1. 1
    ConstruirA API anexa o label 674 e calcula a transação.
  2. 2
    AssinarA wallet autoriza a transação exata.
  3. 3
    AnexarO witness validado vira parte do signed CBOR.
  4. 4
    SubmeterA mensagem e o pagamento são enviados à Preprod.
  5. 5
    ConfirmarVerifique inclusão e metadata no explorador.

Revisão antes da submissão

Construa e assine a transação para ver o resumo.

Exercício 3

Multisig 2-de-2

Duas chaves de pagamento diferentes precisam assinar o mesmo unsigned CBOR para movimentar o saldo do script.

Objetivo

Criar um script 2-de-2, bloquear tADA e desbloquear com dois witnesses.

Concluído quando

O unlock estiver incluído. O valor escolhido vai ao destino e o troco volta ao script.

Efeito da submissão

O lock move tADA para o script 2-de-2; o unlock consome o UTxO somente com os dois witnesses. Sem uma das chaves, o saldo pode ficar inacessível.

3.0 Defina os dois signers

Signer A é a wallet conectada. Signer B fornece outro endereço controlado por uma chave de pagamento diferente.

Conecte o signer A e informe o endereço do signer B.

3A Bloqueie tADA no script

  1. 1
    ConstruirCria um output no script address.
  2. 2
    AssinarSigner A autoriza o gasto de seus inputs.
  3. 3
    AnexarO witness de A é validado e anexado.
  4. 4
    SubmeterMove tADA para o script 2-de-2.
  5. 5
    ConfirmarDepois da inclusão, liste os UTxOs do script.

Revisão do lock

Construa e assine o lock para ver o resumo.

3B Compartilhe, assine e desbloqueie

  1. Signer A lista e escolhe o UTxO, depois constrói o unlock.
  2. Signer A assina e envia somente o unsigned CBOR ao signer B.
  3. Signer B abre a Workbench, conecta sua wallet, cola o unsigned CBOR, assina e devolve seu witness.
  4. Signer A cola o witness recebido, anexa os dois e submete.
  1. 1
    Construir ou importarTodos os signers devem assinar o mesmo unsigned CBOR.
  2. 2
    Coletar duas assinaturasCada witness deve corresponder a uma das chaves exigidas.
  3. 3
    AnexarA Workbench valida assinaturas, signers e corpo da transação.
  4. 4
    SubmeterConsome o UTxO escolhido e devolve o troco ao script.
  5. 5
    ConfirmarVerifique se o unlock foi incluído em um bloco da Preprod.

Revisão obrigatória antes de assinar

Construa ou cole o unsigned CBOR para inspecionar UTxO, destino, valor, troco e signers.

Revisão do unlock

Construa, colete e anexe os witnesses para ver o resumo.

Exercício 4A

Ciclo EAC: emissão e aposentadoria

Use um asset EAC sintético para praticar emissão, aposentadoria parcial e inspeção do ledger. Quantidades e referências existem somente neste exercício.

Objetivo

Emitir 1.000.000 unidades-base, aposentar 125.000 e confirmar o saldo restante de 875.000 no ledger.

Concluído quando

Mint e burn estiverem incluídos, com as referências sintéticas no label 65536 e as quantidades conferidas no ledger.

Efeito da submissão

A emissão cria o asset didático e publica hashes sintéticos. A aposentadoria queima parte do saldo. A policy não valida a metadata nem comprova alegações externas.

Asset name
EAC-WORKSHOP-001
Quantidade no ledger (unidades-base)
1000000
Casas decimais de exibição
3
Quantidade exibida
1.000,000 EAC
Metadata label
65536, private use CIP-10. A metadata continua pública.

Cardano registra quantidades inteiras. Aqui, decimals: 3 é somente uma convenção de exibição: 1 EAC exibido corresponde a 1000 unidades-base no ledger.

  1. 1
    ConstruirCria a policy estável, o mint, o output e a metadata raw.
  2. 2
    AssinarA wallet satisfaz a chave exigida pela policy.
  3. 3
    AnexarValida e adiciona o witness à emissão.
  4. 4
    SubmeterPublica a emissão e as referências na Preprod.
  5. 5
    ConfirmarVerifique campo mint, output e label 65536.

Revisão antes da submissão

Construa e assine a emissão EAC para ver o resumo.

4A.2 Aposentadoria parcial do EAC

Depois da inclusão e indexação, queime 125.000 unidades-base (125,000 EAC) e devolva 875.000 unidades-base (875,000 EAC) à wallet contábil.

Burn no ledger (unidades-base)
-125000
Aposentadoria exibida
125,000 EAC
Saldo no ledger (unidades-base)
875000
Saldo exibido
875,000 EAC

Cardano registra quantidades inteiras. Aqui, decimals: 3 é somente uma convenção de exibição: 1 EAC exibido corresponde a 1000 unidades-base no ledger.

  1. 1
    ConstruirLocaliza o saldo da wallet, cria o burn e devolve o restante.
  2. 2
    AssinarA mesma chave satisfaz a policy estável.
  3. 3
    AnexarValida e adiciona o witness à aposentadoria.
  4. 4
    SubmeterPublica o burn e as referências externas.
  5. 5
    ConfirmarVerifique burn, saldo restante e label 65536.

Revisão da aposentadoria

Construa e assine a aposentadoria EAC para ver o resumo.

Exercício 4B

Media token com CIP-25

Crie um asset nativo com metadata de apresentação no label 721.

Objetivo

Emitir um media token com policy nativa e metadata de nome, imagem e descrição.

Concluído quando

A transação estiver incluída e o asset puder ser localizado pelo policy id.

Efeito da submissão

Cria unidades de um asset na Preprod, usa ao menos 5 tADA no output e paga taxa. A policy expira em cerca de três horas.

  1. 1
    ConstruirCria policy, asset, metadata, validade e output do mint.
  2. 2
    AssinarA wallet satisfaz o required signer da policy.
  3. 3
    AnexarValida e adiciona o witness ao mint.
  4. 4
    SubmeterPublica o mint e a metadata na Preprod.
  5. 5
    ConfirmarVerifique inclusão, policy id e asset name.

Revisão antes da submissão

Construa e assine o mint para ver o resumo.

Código da etapa

Código da etapa

Trecho extraído do código-fonte real executado pela Workbench.

Log técnico

Eventos desta aba em ordem cronológica.