Ferramentas

Instalar#

Os scripts baixam das versões do GitHub e conferem o checksum SHA-256 listado em SHA256SUMS antes de instalar. O script do Linux instala em /usr/local/bin quando há permissão de escrita, senão em ~/.local/bin; TCCL_INSTALL_DIR e TCCL_VERSION mudam isso. O script do Windows instala para o usuário atual em %LOCALAPPDATA%\Programs\tccl e adiciona ao PATH do usuário.

Os binários do Windows ainda não têm assinatura de código, então o Windows SmartScreen pode avisar sobre editor desconhecido. Compare o SHA-256 do arquivo com o SHA256SUMS da página da versão.

Referência da linha de comando#

Opções comuns: --language 1|2 (padrão 2) e --lang en|pt|es para as explicações (ou a variável de ambiente TCCL_LANG).

Opções do run: --state <arquivo> (padrão tccl-state.json), --from <nome> (padrão alice), --value 5tcn, --height <n>, --contract <hex>, --final.

Argumentos seguem os tipos declarados dos parâmetros: 42 ou 2.5tcn (int), true, "texto", 0xabcd, tc1…, @nome para uma conta fictícia, $prefixo-hex para um contrato simulado, [a, b] (listas), {campo: valor} (records) e o nome de uma variante (enums).

Cenários#

Um cenário é um teste em texto simples. Cada linha é um comando; # começa um comentário.

Nos argumentos, $nome é o endereço de um contrato publicado antes no cenário, e @nome uma conta fictícia (funciona também dentro de listas e records). Todo cenário começa numa blockchain simulada nova, em que cada conta tem 1 000 000 TCN.

Playground#

O playground roda o mesmo compilador, máquina virtual e simulador, compilados para WebAssembly, dentro de um Web Worker no seu navegador.

• Editor: destaque de sintaxe, linha e coluna, Tab insere quatro espaços, erros destacados com explicação e correção com um clique para "você quis dizer".
• Executar: publique com contas fictícias, preencha argumentos, chame actions e consulte views, atualize e troque a autoridade.
• Estado: saldos, depósito, versão do código, autoridade e cada variável de estado, com as mudanças destacadas.
• Atividade: cada transação com resultado ou erro explicado, eventos, combustível, taxa e depósito estimados e a lista de mudanças de estado.
• Cenário: roda um cenário com o código do editor.
• Sessão: define a altura do bloco, exporta e importa a blockchain simulada, reinicia.
• Arquivos: abra e salve arquivos .tccl, ou arraste um para o editor.

Ele nunca pede chaves nem frases de recuperação e nunca acessa uma rede. Pedidos que levam mais de cinco segundos são interrompidos; cada chamada tem no máximo 5 000 000 de combustível e 16 MiB.

Simulação, testnet e mainnet#

Testnet#

Publique com a carteira do software do nó (veja the-coin.cloud). Verifique o contrato com --language 1 antes, porque a rede roda a versão 1 da linguagem:

tccl check --language 1 contract.tccl
thecoin-wallet --network testnet contract deploy contract.tccl [args do init…] [--value TCN] [--max-fuel N] [--max-deposit TCN]
thecoin-wallet --network testnet contract invoke <endereço> <função> [args…] [--value TCN]
thecoin-wallet --network testnet contract view <endereço> <função> [args…]
thecoin-wallet --network testnet contract program <endereço>

A carteira simula cada chamada sobre o estado atual antes e não envia uma chamada que falharia.

Mainnet#

Os mesmos comandos sem --network testnet usam TCN real. Antes de publicar: siga o checklist de segurança, rode o contrato na testnet, publique o código e peça uma revisão. Na The Coin v0.2.0 o código publicado não pode ser alterado.

Melhore esta página no GitHub