Cardano Technical Workshop
Workbench de transações Cardano
Construa, assine, inspecione e submeta transações na Cardano Preprod.
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.
- Blockfrost PreprodConfigure BLOCKFROST_PROJECT_ID no ambiente do backend.
- Wallet CIP-30Instale e desbloqueie uma extensão compatível.
- Wallet em testnetSelecione Preprod na extensão antes de conectar.
- 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.
Enviar uma quantidade definida de lovelace para outro endereço.
O hash aparecer como incluído em um bloco da Preprod.
Gasta tADA e taxa da wallet conectada. Depois de incluída, a transferência não pode ser desfeita.
- 1ConstruirA API consulta UTxOs e calcula inputs, outputs, taxa e troco.
- 2AssinarA extensão mostra a transação e produz um witness sem expor a chave.
- 3AnexarA Workbench valida o witness contra o corpo e cria o signed CBOR.
- 4SubmeterRevise o efeito e envie a transação assinada à Preprod.
- 5ConfirmarVerifique se o hash foi incluído em um bloco.
Detalhe técnico
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.
Relacionar uma mensagem pública a uma transação de pagamento.
A transação estiver incluída e o label 674 puder ser inspecionado.
Transfere tADA e publica a mensagem permanentemente. Não use dados pessoais ou sigilosos.
- 1ConstruirA API anexa o label 674 e calcula a transação.
- 2AssinarA wallet autoriza a transação exata.
- 3AnexarO witness validado vira parte do signed CBOR.
- 4SubmeterA mensagem e o pagamento são enviados à Preprod.
- 5ConfirmarVerifique inclusão e metadata no explorador.
Detalhe técnico
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.
Criar um script 2-de-2, bloquear tADA e desbloquear com dois witnesses.
O unlock estiver incluído. O valor escolhido vai ao destino e o troco volta ao script.
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.
Detalhe técnico
3A Bloqueie tADA no script
- 1ConstruirCria um output no script address.
- 2AssinarSigner A autoriza o gasto de seus inputs.
- 3AnexarO witness de A é validado e anexado.
- 4SubmeterMove tADA para o script 2-de-2.
- 5ConfirmarDepois da inclusão, liste os UTxOs do script.
Detalhe técnico
Revisão do lock
Construa e assine o lock para ver o resumo.
3B Compartilhe, assine e desbloqueie
- Signer A lista e escolhe o UTxO, depois constrói o unlock.
- Signer A assina e envia somente o unsigned CBOR ao signer B.
- Signer B abre a Workbench, conecta sua wallet, cola o unsigned CBOR, assina e devolve seu witness.
- Signer A cola o witness recebido, anexa os dois e submete.
- 1Construir ou importarTodos os signers devem assinar o mesmo unsigned CBOR.
- 2Coletar duas assinaturasCada witness deve corresponder a uma das chaves exigidas.
- 3AnexarA Workbench valida assinaturas, signers e corpo da transação.
- 4SubmeterConsome o UTxO escolhido e devolve o troco ao script.
- 5ConfirmarVerifique se o unlock foi incluído em um bloco da Preprod.
Detalhe técnico
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.
Emitir 1.000.000 unidades-base, aposentar 125.000 e confirmar o saldo restante de 875.000 no ledger.
Mint e burn estiverem incluídos, com as referências sintéticas no label 65536 e as quantidades conferidas no ledger.
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.
- 1ConstruirCria a policy estável, o mint, o output e a metadata raw.
- 2AssinarA wallet satisfaz a chave exigida pela policy.
- 3AnexarValida e adiciona o witness à emissão.
- 4SubmeterPublica a emissão e as referências na Preprod.
- 5ConfirmarVerifique campo mint, output e label 65536.
Detalhe técnico
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.
- 1ConstruirLocaliza o saldo da wallet, cria o burn e devolve o restante.
- 2AssinarA mesma chave satisfaz a policy estável.
- 3AnexarValida e adiciona o witness à aposentadoria.
- 4SubmeterPublica o burn e as referências externas.
- 5ConfirmarVerifique burn, saldo restante e label 65536.
Detalhe técnico
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.
Emitir um media token com policy nativa e metadata de nome, imagem e descrição.
A transação estiver incluída e o asset puder ser localizado pelo policy id.
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.
- 1ConstruirCria policy, asset, metadata, validade e output do mint.
- 2AssinarA wallet satisfaz o required signer da policy.
- 3AnexarValida e adiciona o witness ao mint.
- 4SubmeterPublica o mint e a metadata na Preprod.
- 5ConfirmarVerifique inclusão, policy id e asset name.
Detalhe técnico
Revisão antes da submissão
Construa e assine o mint para ver o resumo.