Initiate your first transaction

Now that you've set up your wallet and obtained some Testnet tokens, let's dive into initiating your first transaction. It's simpler than you might think, especially with our streamlined approach.

Cross-Blockchain Transfers: Tokens are native to specific blockchains, meaning they can't be sent directly across different chains. For instance, Ethereum tokens stay on the Ethereum network unless other mechanisms, like bridges, are used.

Getting the tokenId

Before we can proceed, we need to determine the tokenId. You can do this by retrieving the token balances for your wallet.

Fetching your wallet balance

Try it out:Get your wallet balance

Key Transaction Parameters:

Request Parameters

  • idempotencyKey

    A unique string that ensures your transaction isn 't processed more than once even if sent multiple times. A critical measure to prevent duplicates.

  • amounts

    Specify the amount of tokens you're transferring.

  • destinationAddress

    The wallet address where you're sending the tokens.

  • entitySecretCiphertext

    A crucial security layer, this encrypted string ensures only authorized transactions go through.

  • tokenId

    This is the id we just extract from your wallet balance. It is the unique identifier for the specific token type you're moving. This id is unique.

  • walletId

    Indicates the source of the transaction, i.e., from which wallet you're sending the tokens.

The above parameters are just the essentials for initiating a transaction. The endpoint offers a richer, more detailed configuration to cater to a variety of transaction types and needs. For a comprehensive understanding and to leverage advanced features, we recommend referring to the official documentation.

Creating a transaction

Try it out:Initiate your transaction


Blockchain transactions pose a challenge with gas fees. Gas fees are charges in blockchain networks, typically paid with native assets like Ether (ETH) on Ethereum. This complicates the user experience as it requires users to hold these assets.

However, with Developer-Controlled smart contract wallets, you can sponsor gas fees, removing the need to possess native assets. The Gas Station acts as an intermediary, allowing you to cover fees for your users, improving their transaction experience. In testnet, the Gas Station is already setup for you, ready for testing. In the Production phase, you gain more control with spending limits and configuration options. Learn more here.

Once you've validated your transaction and everything checks out, you're all set. Transactions on the blockchain are immutable, meaning once they're validated, they cannot be reversed or altered. So, always double-check before sending!

Need help or have questions?

Here are some helpful links:

🎥Watch and learn: Watch our step-by-step walkthrough of the guide
🎮Join our Discord Community: Engage, learn, and collaborate.
🛎Visit our Help-Desk Page: Dive into curated FAQs and guides.
📧Direct Email: We're always a message away.
📖Read docs: Check out our developer documentation.
© 2023 Circle Technology Services, LLC. All rights reserved.