Prepare Transactions

curl --request POST \
  --url https://api.sandbox.brickken.com/prepare-transactions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "method": "newTokenization",
  "signerAddress": "0xSignerAddress",
  "tokenizerEmail": "tokenizer.email@example.com",
  "chainId": "aa36a7",
  "symbol": "BKN",
  "supplyCap": "10",
  "name": "Brickken",
  "gasLimit": "2000000 but can be omitted",
  "rpcUrl": "{URL_TO_RPC} but can be omitted"
}'

{
  "transactions": [
    {
      "from": "<string>",
      "to": "<string>",
      "value": {
        "type": "<string>",
        "hex": "<string>"
      },
      "nonce": 123,
      "chainId": 123,
      "data": "<string>",
      "type": 123,
      "maxPriorityFeePerGas": {
        "type": "<string>",
        "hex": "<string>"
      },
      "maxFeePerGas": {
        "type": "<string>",
        "hex": "<string>"
      },
      "gasLimit": {
        "type": "<string>",
        "hex": "<string>"
      }
    }
  ]
}

Transaction Endpoints

Prepare Transactions

Description: This endpoint prepares unsigned transactions for various blockchain operations. The operation is determined by the method field in the request body. Supported methods include: newTokenization, mintToken, whitelist, burnToken, approve, transferTo, transferFrom, dividendDistribution, and newSto.

Headers:

x-api-key: YOUR_API_KEY
Content-Type: application/json

Common Request Body Parameters:

method (string): Operation to perform.
signerAddress (string): Address initiating the transaction.
chainId (string): Chain ID in hex (e.g., “aa36a7”).
gasLimit (string, optional): Optional gas limit.
rpcUrl (string, optional): Optional RPC URL.

Method: newTokenization Prepares a new tokenization transaction.

Additional Request Body Parameters:

url (string): Token documentation URL.
name (string): Token name.
symbol (string): Token symbol (max 5 characters).
tokenizerEmail (string): The email of the tokenizer.
supplyCap (string, optional): Max token supply.
preMints (array, optional): Pre-mint configurations.
initialHolders (array, optional): Initial holder configurations.

Method: mintToken Prepares minting tokens to users.

Additional Request Body Parameters:

tokenSymbol (string): Symbol of the token.
userToMint (array of objects): Each object includes:
- email (string)
- investorAddress (string)
- amount (string)
- needWhitelist (boolean)

Method: whitelist Whitelists or blacklists users.

Additional Request Body Parameters:

tokenSymbol (string): Symbol of the token.
userToWhitelist (array of objects): Each includes:
- whitelistStatus (string): “true” or “false”.
- investorAddress (string)

Method: burnToken Burns tokens from the signer’s balance.

Additional Request Body Parameters:

tokenSymbol (string): Symbol of the token.
amount (string): Amount to burn.

Method: transferFrom Transfers tokens from one address to another (with prior approval).

Additional Request Body Parameters:

tokenSymbol (string): Symbol of the token.
from (string): Sender address.
to (string): Receiver address.
amount (string): Amount to transfer.

Method: transferTo Transfers tokens from signerAddress to another address.

Additional Request Body Parameters:

tokenSymbol (string): Symbol of the token.
to (string): Receiver address.
amount (string): Amount to transfer.

Method: approve Approves a spender to use tokens.

Additional Request Body Parameters:

tokenSymbol (string): Token to approve (can include BKN, USDT, USDC).
spenderAddress (string): Address being approved.
amount (string): Allowance amount.

Method: dividendDistribution Distributes paymentToken dividends to holders of tokenSymbol.

Additional Request Body Parameters:

tokenSymbol (string)
amount (string): Amount of payment token to distribute.

Note: Amounts are in whole units (e.g., 10 for 10 USDT).

Method: newSto Creates a new STO (Security Token Offering).

Additional Request Body Parameters:

tokenizerEmail (string)
tokenAmount (string)
offeringName (string)
startDate (string)
endDate (string)
acceptedCoin (string)
minRaiseUSD (string)
maxRaiseUSD (string)
minInvestment (string)
maxInvestment (string)
signerAddress (string)

POST

/

prepare-transactions

Prepare Transactions

curl --request POST \
  --url https://api.sandbox.brickken.com/prepare-transactions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "method": "newTokenization",
  "signerAddress": "0xSignerAddress",
  "tokenizerEmail": "tokenizer.email@example.com",
  "chainId": "aa36a7",
  "symbol": "BKN",
  "supplyCap": "10",
  "name": "Brickken",
  "gasLimit": "2000000 but can be omitted",
  "rpcUrl": "{URL_TO_RPC} but can be omitted"
}'

{
  "transactions": [
    {
      "from": "<string>",
      "to": "<string>",
      "value": {
        "type": "<string>",
        "hex": "<string>"
      },
      "nonce": 123,
      "chainId": 123,
      "data": "<string>",
      "type": 123,
      "maxPriorityFeePerGas": {
        "type": "<string>",
        "hex": "<string>"
      },
      "maxFeePerGas": {
        "type": "<string>",
        "hex": "<string>"
      },
      "gasLimit": {
        "type": "<string>",
        "hex": "<string>"
      }
    }
  ]
}

Prepares unsigned transactions for various blockchain operations. This endpoint supports multiple transaction methods for tokenization, STO management, token operations, and more.

Common Parameters

Parameter	Type	Required	Description
`chainId`	string	Yes	Blockchain network identifier (hex format)
`method`	string	Yes	Transaction method type
`signerAddress`	string	Yes	Address that will sign the transaction

Supported Methods

newTokenization

Creates a new tokenized asset.

{
  "method": "newTokenization",
  "tokenizerAddress": "0xB610470ae0fEa78A1B27cD3F0D4011eb5361fAf1",
  "chainId": "aa36a7",
  "rpcUrl": null,
  "url": "url",
  "name": "namcace98",
  "tokenizerEmail": "davide.pizzo+groc14@brickken.com",
  "tokenSymbol": "VZV98",
  "supplyCap": "0",
  "preMints": [],
  "initialHolders": []
}

newSto

Creates a new Security Token Offering.

{
  "method": "newSto",
  "signerAddress": "0xB610470ae0fEa78A1B27cD3F0D4011eb5361fAf1",
  "chainId": "aa36a7",
  "gasLimit": null,
  "rpcUrl": null,
  "tokenizerEmail": "davide.pizzo+groc14@brickken.com",
  "tokenAmount": "1000",
  "offeringName": "FE Test STO 5",
  "startDate": "2025-08-26T17:30:00.000Z",
  "endDate": "2025-10-02T00:00:00.000Z",
  "acceptedCoin": "USDT",
  "minRaiseUSD": "10",
  "maxRaiseUSD": "100",
  "minInvestment": "10",
  "maxInvestment": "100",
  "tokenSymbol": "VZV99"
}

newInvest

Makes an investment in an STO.

{
  "method": "newInvest",
  "investorAddress": "0xB610470ae0fEa78A1B27cD3F0D4011eb5361fAf1",
  "chainId": "aa36a7",
  "investorEmail": "davide.pizzo+groci1@brickken.com",
  "tokenSymbol": "INDS",
  "investmentAmount": "10",
  "paymentTokenSymbol": "USDT"
}

claimTokens

Claims tokens from a completed STO.

{
  "method": "claimTokens",
  "investorAddress": "0x98Bc5C91aeF60ad4Ef0BCCaa8D3da87185E5ec77",
  "chainId": "aa36a7",
  "investorEmail": "jordi.vallejo+groc+inv03@brickken.com",
  "tokenSymbol": "N26A0",
  "paymentTokenSymbol": "USDT"
}

mintToken

Mints additional tokens to specified addresses.

{
  "method": "mintToken",
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "chainId": "aa36a7",
  "tokenSymbol": "EXMPL",
  "investorAddress": "0x789abc123def456ghi789jkl012mno345pqr678",
  "userToMint": [
    {
      "email": "user@example.com",
      "investorAddress": "0x789abc123def456ghi789jkl012mno345pqr678",
      "amount": "500",
      "needWhitelist": true
    }
  ]
}

whitelist

Manages whitelist status for addresses.

{
  "method": "whitelist",
  "signerAddress": "0x060BC1F72e7a55fD3bABcFf841836e86A77BCb9A",
  "chainId": "aa36a7",
  "gasLimit": null,
  "rpcUrl": null,
  "tokenSymbol": "N26A0",
  "investorEmail": "jordi.vallejo+groc+inv02@brickken.com",
  "userToWhitelist": [
    {
      "whitelistStatus": true,
      "investorAddress": "0x6712513BF6C53df35A7174FE662dBe0Fbc967CE9"
    }
  ]
}

approve

Approves another address to spend tokens on behalf of the signer.

{
  "chainId": "0x89",
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "method": "approve",
  "tokenSymbol": "EXMPL",
  "spenderAddress": "0x456...",
  "amount": "100"
}

burnToken

Burns tokens from the signer’s address.

{
  "chainId": "0x89",
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "method": "burnToken",
  "tokenSymbol": "EXMPL",
  "amount": "100"
}

transferFrom

Transfers tokens from one address to another (requires approval).

{
  "chainId": "0x89",
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "method": "transferFrom",
  "tokenSymbol": "EXMPL",
  "from": "0x123...",
  "to": "0x456...",
  "amount": "50"
}

transferTo

Transfers tokens from signer’s address to another address.

{
  "chainId": "0x89",
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "method": "transferTo",
  "tokenSymbol": "EXMPL",
  "to": "0x456...",
  "amount": "50"
}

dividendDistribution

Distributes dividends to token holders.

{
  "chainId": "0x89",
  "signerAddress": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
  "method": "dividendDistribution",
  "tokenSymbol": "EXMPL",
  "amount": "1000"
}

Response Format

{
  "txId": "tx_abc123def456",
  "transactions": [
    {
      "to": "0x742d35Cc6634C0532925a3b8D4C9db96c4b4d8b",
      "data": "0x...",
      "value": "0",
      "gasLimit": "500000",
      "maxFeePerGas": "20000000000",
      "maxPriorityFeePerGas": "2000000000",
      "nonce": 42,
      "type": 2,
      "chainId": "0x89"
    }
  ]
}

Authorizations

x-api-key

string

header

required

Body

application/json

method

string

The operation to be performed. Possible values are newTokenization, mintToken, whitelist, burnToken, transferFrom, transferTo, approve, dividendDistribution, newSto.

Example:

"newTokenization"

signerAddress

string

The address of the user initiating the transaction.

Example:

"0xSignerAddress"

tokenizerEmail

string

The email of the user.

Example:

"tokenizer.email@example.com"

chainId

string

The blockchain network's chain ID in hexadecimal format (e.g., "aa36a7" for Sepolia testnet).

Example:

"aa36a7"

symbol

string

The token symbol (max 5 characters).

Example:

"BKN"

supplyCap

string

Max token supply.

Example:

"10"

name

string

Name of the token.

Example:

"Brickken"

gasLimit

string

An amount of gas units as limits. If not specified, it will be automatically estimated.

Example:

"2000000 but can be omitted"

rpcUrl

string

The RPC URL of the blockchain network. If not provided, a default RPC URL for the specified chain ID will be used.

Example:

"{URL_TO_RPC} but can be omitted"

Response

200 - application/json

Successful response

transactions

object[]

Show child attributes

Introduction Send Transactions