Send and Monitor Transactions
Syndicate’s transaction broadcasting and monitoring infrastructure allows you to put any transaction on any EVM-compatible chain without having to manage private keys, host your own secure signing infrastructure, or worry about technical nuances like nonce conflicts.
We ensure that any valid transaction will end up in a block regardless of reorgs, dropped transactions, or gas spikes all while supporting throughput of 5,000+ transaction requests per second. By the end of this guide you’ll have:
- Authorized a new contract call on your project
- Broadcast a transaction via the Syndicate API
- Registered a webhook to receive realtime updates about transaction statuses
- Queried the status of the transaction to get the full receipt
Authorizing a contract call
To ensure the security of project, we require that you explicitly set the contract addresses and function ABI’s that can be called. In the Syndicate dashboard go to your project and then click Settings (⚙️) > Contracts > Add Contract. In this guide we’ll be calling our Demo mint module on Mumbai but you can enter in any valid ABI on any EVM-compatible chain. Enter in the following information in the form:
| Input | Value |
|---|---|
| Name | Syndicate Demo Mint Module |
| Contract Address | 0xbEc332E1eb3EE582B36F979BF803F98591BB9E24 |
| Contract ABI | [{"inputs": [{"name": "account","type": "address"}],"name": "mint","outputs": [],"stateMutability": "nonpayable","type": "function"}] |
| Allowed Functions | “mint” |
| Network | Polygon Mumbai |
Broadcast your transaction
Syndicate’s infrastructure submits your requested transaction from the most optimal wallet associated with your project to achieve maximum transaction throughput. Ensure that all of the wallets in your project have enough gas to submit your transaction. The command will return a transactionID UUID that you can use in the next steps to query the status of your request so keep it handy. Copy the curl command below and replace the <api-key>, <project-id>, and <recipient-address> with your own values, the first two can be found in the dashboard Settings (⚙️).
curl -H 'Authorization: Bearer <api-key>' \
-H "Content-type: application/json" \
-d '{ "projectId": "<project-id>","contractAddress":"0xbEc332E1eb3EE582B36F979BF803F98591BB9E24","chainId":80001,
"functionSignature":"mint(address account)",
"args":{"account":"<recipient-address>"}}' \
'https://api.syndicate.io/transact/sendTransaction'
The type of functionSignature is Human Readable
ABI.
This is the format displayed in the Contracts page after you authorize a
function so we recommend you start there.
Register a webhook for transaction status (Under Development)
If you would like to be notified about changes in the status of your broadcast transaction you can register a webhook via the API. By listening to transactions as they update from pending in our system to included in a block, you can build rich in-app experiences for your users with response times faster than any indexing service.
To register your webhook, you can use the following curl command. Your webhook callback URL should be in the format of https://your-app-webhook-endpoint.com/webhook, where the endpoint path, /webhook in this case, will receive the incoming transaction status updates.
For complete documentation on the endpoint, see Create Callback.
curl -X POST \
-H 'Authorization: Bearer <api-key>' \
-H "Content-type: application/json" \
-d '{"callbackURL": "<callback-url>","eventType": "TransactionStatusChange"}' \
'https://api.syndicate.io/webhook/project/{projectId}/createEventCallback'
Query the status of your transaction
You can query an individual transaction with the Get Request by ID endpoint using the transactionId from the steps above:
curl -H 'Authorization: Bearer <api-key>' \
'https://api.syndicate.io/wallet/project/{projectId}/request/{transactionId}'
Let’s break down some of the fields in the response object you’ll receive.
| Selected Field | Meaning |
|---|---|
| data | This is the RLP encoding of your requested transaction. |
| invalid | If true, we determined your transaction request was malformed and cannot be submitted to the chain. |
| transactionAttempts | If an empty list is returned, your transaction request is still being processed by our infrastructure and should be submitted to the mempool shortly. |
Let’s dive further into transactionAttempts. Since Syndicate handles dropped transactions, reorgs and gas spikes for you, we may need to submit your transaction multiple times before it is included in a block. Each time we submit your transaction we create a new transactionAttempt object, let’s review some key fields in the object.
| Selected Field | Meaning |
|---|---|
| hash | This is the transaction hash of the submitted transaction. If a value is present you can query it in the blockviewer associated with the chain like etherscan.io for Ethereum mainnet. |
| nonce | The sequentially increasing and unique integer the wallet chosen used to submit the transaction. |
| reverted | If true, the transaction made it on chain but reverted. Learn more about that status. |
| status | PENDING means the transaction attempt is currently in the mempool. SUBMITTED means the transaction made it into a block. CONFIRMED means Syndicate has identified that the transaction is permanently on-chain and will not be reverted or dropped. |
| walletAddress | The wallet in your project Syndicate selected to submit the transaction with. |
What’s next?
To see Syndicate’s scaling power at work, submit many transactions simultaneously and let our infrastructure handle the rest. You can also authorize additional contracts and functions to call in your project to expand your application’s functionality. If you haven’t already set up an IP range allowlist for your project, follow our IP Allowlist Guide to protect your keys.