Skip to main content

Transactions

Transactions are the building material of the blockchain. Every payload you submit gets signed by your wallet and stored into blocks which then are shared across every node in the network creating the immutable ledger.

Registering your wallet — the first transaction​

Before you can submit any transaction, your wallet needs to be registered on the blockchain, which is a transaction by itself.

Do this once per wallet per blockchain.

const res = await fetch('https://your-tms-url/api/v1/transactions/register-wallet', {
  method: 'POST',
  headers: {
    'X-AccessKey': 'your-entity-access-key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    walletAddress: 'your-wallet-address',
    blockchain: '08c28f29a62819120958984b761ddf8ccb45951612731409873994958fd150a2',
    passphrase: 'my-secure-passphrase',  // omit if wallet has no passphrase
  }),
});

const result = await res.json();
console.log('Wallet registered:', result);

After this the wallet is live on the chain and ready to use.

Submitting a transaction​

With the wallet registered, you can write anything to the blockchain. The TMS picks an available node from your access key's allowed nodes and forwards the transaction taking care of the routing and queuing for you.

const res = await fetch('https://your-tms-url/api/v1/transactions', {
  method: 'POST',
  headers: {
    'X-AccessKey': 'your-entity-access-key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    blockchainId: '08c28f29a62819120958984b761ddf8ccb45951612731409873994958fd150a2',
    from: 'your-wallet-address',
    to: 'your-wallet-address',
    walletAddress: 'your-wallet-address',
    passphrase: 'my-secure-passphrase',
    payload: 'anything you want to store permanently',
    payloadType: 'DATA',
    metadata: {
      source: 'my-app',
      version: '1.0',
    },
  }),
});

const tx = await res.json();
console.log('Transaction ID:', tx.transactions.transactionId);

Retrieving a transaction​

Once submitted, verify the transaction made it in:

const blockchainId = '08c28f29a62819120958984b761ddf8ccb45951612731409873994958fd150a2';
const transactionId = 'your-transaction-id';

const res = await fetch(
  `https://your-tms-url/api/v1/transactions/${blockchainId}/${transactionId}`,
  {
    headers: {
      'X-AccessKey': 'your-entity-access-key',
      'Accept': 'application/json',
    },
  }
);

const confirmed = await res.json();
console.log('Status:', confirmed.status);
console.log('Payload:', confirmed.payload);

Transactions in ULedger are incredibly fast. Go check on the transactions immediately after submitting and see how quickly they get confirmed.

Blocks and the ledger​

Transactions get packed into blocks with up to 200 per block. Once a block is sealed it's distributed across all nodes in your network. That's the immutable record forming in real time.

Read a block to see everything that landed in it:

const res = await fetch('https://your-tms-url/api/v1/nodes/blockchain-block', {
  method: 'POST',
  headers: {
    'X-AccessKey': 'your-entity-access-key',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    nodeId: 'your-node-id',
    blockchain: '08c28f29a62819120958984b761ddf8ccb45951612731409873994958fd150a2',
    blockHeight: 2301,
  }),
});

const block = await res.json();
console.log('Transactions in block:', block.transactions.length);
block.transactions.forEach(tx => console.log(tx.transactionId));

That's the ledger. Wallets sign it, transactions fill it, blocks seal it, nodes hold it.

Up Next​

Now we can go explore smart contracts. Head to Smart Contracts to see how to deploy and interact with smart contracts on ULedger.