Docs
Your first smart contract

8. Deploy to testnet

Create a funded testnet wallet, deploy the poll, verify source code, and retrace a transaction.

Testnet only

All commands on this page target testnet. Testnet GRAM has no real value, but treat the wallet mnemonic with the same care as a mainnet wallet — never commit it to git.

Create and fund a testnet wallet

acton wallet new --name testnet-deployer --local --airdrop --version v5r1
terminal
$ acton wallet new --name testnet-deployer --local --airdrop --version v5r1
✓ Wallet successfully created and added to wallets.toml
✓ Wallet address is kQCC94LVUO3dVUBgBKKHhw-i3GyXwEIy4BH3rymKB0iamEo9
→ Requesting airdrop for wallet testnet-deployer kQCC94LVUO3dVUBgBKKHhw-i3GyXwEIy4BH3rymKB0iamEo9
→ Fetching PoW challenge...
→ Solving challenge (difficulty: 24 bits)...

To check wallet balances run acton wallet list --balance.

--airdrop requests test GRAM from the configured faucet. If the faucet is rate-limited, fund the wallet manually via the Testnet Giver Bot.

acton wallet list --balance

acton wallet list --balance queries TON Center for live balances. Set TONCENTER_TESTNET_API_KEY in the environment for a higher rate limit.

If you already have a wallet, import it instead of creating a new one:

acton wallet import --name testnet-deployer --local --version v5r1 "word1 word2 ... word24"

Deploy to testnet

Replace scripts/deploy.tolk with:

import "@acton/io"
import "@acton/emulation/network"
import "@acton/emulation/scripts"

import "@contracts/types"
import "@wrappers/Poll.gen"

fun main() {
    val deployer = scripts.wallet("testnet-deployer");

    val poll = Poll.fromStorage(PollStorage {
        owner: deployer.address,
        option0: 0,
        option1: 0,
        isClosed: false,
    });
    val res = poll.deploy(deployer.address, { value: grams("0.05") });
    println(res.waitForTrace());

    println("Deployed Poll contract to {}", poll.address);
    println("Owner is {}", poll.owner());
}
acton script scripts/deploy.tolk --net testnet
terminal
$ acton script scripts/deploy.tolk --net testnet
Awaiting trace... [Attempt 1/20]
Trace settled with 2 transaction(s)
N/A -> external
└── ext-in 0x7369676e -> EQD36X..ur8XSS A                                       gas=4939
    └── empty 0.05 GRAM -> EQBa78..XUMpRe B                                      gas=625

Deployed Poll contract to kQBa78G2p3zgNdJeCdO3KFv6hI7N55UxOegiplShSGXUMi_U
Owner is kQD36XRy1ISfSB8zmlSQKBsa5bmeixAWwD6vUUhOXXur8c8Y

Inspect on-chain state

acton rpc info <POLL_ADDRESS> --net testnet

<POLL_ADDRESS> — the address printed by the deployment script.

terminal
$ acton rpc info kQBa78G2p3zgNdJeCdO3KFv6hI7N55UxOegiplShSGXUMi_U --net testnet

Remote Account
  Network:           testnet
  Address:           kQBa78G2p3zgNdJeCdO3KFv6hI7N55UxOegiplShSGXUMi/U
  Raw Address:       0:5aefc1b6a77ce035d25e09d3b7285bfa848ecde7953139e822a654a14865d432
  Status:            active
  Balance:           0.049958332 GRAM
  Last Tx LT:        69241750000003
  Last Tx Hash:      cfvZg4EhUBUFvNNavnJ6y9Woe0IRPRscrZndA2ShzUw=
  Code Hash:         0x9e77c11a8c480d325165387def822b80043c61c41144e938a20e9924b1deb486
  Data Hash:         0x0ed71cf812fb65771b02e9675c0a46aed8bf0b6d81a29082d814c83528935749

Local Match
  Contract:          Poll (Poll)

Decoded Storage
  isClosed: false
  option0: 0
  option1: 0
  owner: kQD36XRy1ISfSB8zmlSQKBsa5bmeixAWwD6vUUhOXXur8c8Y

Verify the source code

Available since: Acton 1.2

Source verification publishes the Tolk sources that reproduce the poll's compiled code hash. Use the same source revision and compiler settings as deployment.

First, prepare verification and inspect the payment details:

acton verify Poll --address <POLL_ADDRESS> --dry-run

Acton compiles the poll and requests a verification ticket. If the code hash is already verified, Acton prints its verifier link and exits without payment.

For new code, Acton checks that the deployed testnet contract has the same code hash. A mismatch stops verification before payment. Acton then prepares the sources and displays the ticket's payment amount, recipient address, and comment.

--dry-run does not send a payment or upload sources. It does not confirm that the verifier can compile the source bundle.

To complete verification, pay with the testnet wallet created earlier:

acton verify Poll --address <POLL_ADDRESS> --wallet testnet-deployer

Review the amount and recipient, then approve the payment when prompted. The ticket sets the amount. Keep enough testnet GRAM in testnet-deployer for this payment and network fees.

Acton waits for the recipient transaction to finalize, then uploads the sources with that transaction's hash. On success, it prints a link that identifies the verified code hash:

terminal
✓ Contract verification completed!
View at: https://verifier.ton.org/<CODE_HASH>

Open the printed link to inspect the verified sources. See the verification guide for TON Connect, compiler options, and payment retries.

Send a vote and retrace the transaction

Create scripts/vote.tolk:

scripts/vote.tolk
import "@acton/io"
import "@acton/prompts"
import "@acton/emulation/network"
import "@acton/emulation/scripts"

import "@wrappers/Poll.gen"

fun main(pollAddress: address, option: uint8) {
    val voter = scripts.wallet(promptWallet("Select voter address"));
    val poll = Poll.fromAddress(pollAddress);

    val res = poll.sendVote(voter.address, option, { value: grams("0.1") });
    println(res.waitForTrace());

    val (option0, option1) = poll.results();
    println("Results: option0={}, option1={}", option0, option1);
}

The two command-line arguments become pollAddress and option:

acton script scripts/vote.tolk --net testnet <POLL_ADDRESS> 0
terminal
$ acton script --net testnet scripts/vote.tolk kQBa78G2p3zgNdJeCdO3KFv6hI7N55UxOegiplShSGXUMi_U 0
Awaiting trace... [Attempt 1/20]
Trace settled with 3 transaction(s)
N/A -> external
└── ext-in 0x7369676e -> EQD36X..ur8XSS A             gas=4939
    └── 0x694d6f6e 0.1 GRAM -> EQBa78..XUMpRe B        gas=4111
        └── 0x694d6f6e 0.05 GRAM -> EQAHvY..Kbp9gT C   gas=1406
            └── account created

Results: option0=1, option1=0

Use acton retrace with the matching local contract to replay the exact testnet transaction locally:

To inspect the raw on-chain trace first, use acton rpc trace:

acton rpc trace <TX_HASH> --net testnet
terminal
$ acton rpc trace 9e2fd109fc5f7eb7340d4b108e861b710523641ae37f0e810ca13e513e8b7ec8 --net testnet
Trace Summary
  Query Hash:        9e2fd109fc5f7eb7340d4b108e861b710523641ae37f0e810ca13e513e8b7ec8
  Trace ID:          XBqC0K8oPX19R7rykhyFQwTwiLyhUulopbdEVMqzFOE=
  Root Tx Hash:      XBqC0K8oPX19R7rykhyFQwTwiLyhUulopbdEVMqzFOE=
  Trace Complete:    true
  Total Txs:         3
  Total Messages:    3

Trace Tree
N/A -> external
└── ext-in 0x7369676e -> EQD36X..ur8XSS A   gas=4939
    └── Vote 0.1 GRAM -> Poll B              gas=4111
        └── Vote 0.05 GRAM -> Voter C        gas=1406
            └── account created

Then use acton retrace with the matching local contract to replay the same transaction locally:

acton retrace <TX_HASH> --net testnet --contract Poll

<TX_HASH> — the transaction hash printed by the vote script.

terminal
$ acton retrace 9e2fd109fc5f7eb7340d4b108e861b71052...7ec8 --net testnet --contract Poll
Network:             testnet
State Hash OK:       Yes

Transaction Details:
  Status:         Success (exit code: 0)
  Account:        UQBa78G2p3zgNdJeCdO3KFv6hI7N55UxOegiplShSGXUMsmb
  Sender:         UQD36XRy1ISfSB8zmlSQKBsa5bmeixAWwD6vUUhOXXur8SlX
  LT:             69241811000003
  Time:           13.05.2026, 00:23:03
  Amount In:      0.100000000 GRAM

Fees & Balance:
  Balance Before: 0.049958332 GRAM
  Amount Sent:    0.050000000 GRAM
  Total Fee:      0.000326935 GRAM
  Gas Fee:        0.000274068 GRAM
  Balance After:  0.099525662 GRAM

Compute Phase:
  Success:        Yes
  Exit Code:      0
  VM Steps:       78
  Gas Used:       4111
  Gas Fees:       0.000274068 GRAM

Action Phase:
  Success:        Yes
  Total Actions:  1

Out Actions:
  1. Send Message
     Mode:           PAY_FEES_SEPARATELY
     Destination:    UQAHvYVFogKzuNpQLwqimwGqKM_Ceg757jxn9cPTYSKbp4XW
     Value:          0.050000000 GRAM
     Bounce:         Yes
     Body Hash:      0xa1234d20a2eb8fca273a9d8aba3c438a253c3984ea880b0fcb9d6f38db55260f

Help: Some fields are shown as hashes. Use --verbose to see full cell content.

Message Data:
  Opcode:         0x694d6f6e

Help: Use --logs-dir <DIR> to save full VM and executor logs to files.

Add --debug when you want source-level replay in the editor with the retrace DAP server.

Checkpoint

The poll is live and verified on the testnet:

  • Deploy with acton script scripts/deploy.tolk --net testnet
  • Inspect state with acton rpc info --net testnet
  • Debug transactions with acton retrace --contract Poll
  • Source visible at verifier.ton.org

The next page builds the React frontend.

Commands introduced: acton wallet, acton script --net testnet, acton rpc info --net testnet, acton verify, acton retrace

Last updated on

7. Close the poll

Add a ClosePoll message, owner access control, and a gas snapshot baseline.

9. Build the React frontend

Generate a TypeScript wrapper, scaffold a TON dApp with Vite + React + TON Connect UI, and build a live poll page.

On this page

Create and fund a testnet wallet
Deploy to testnet
Inspect on-chain state
Verify the source code
Send a vote and retrace the transaction
Checkpoint