Get started

Push Chain enables users to build Consumer-centric Apps with high scalability and better UX.

Speed run

The following speed run is designed to give you a quick overview of usage and demonstrates how Push Chain SDK can be integrated successfully in minimal lines of code.

js

// Import Push Chain SDK for blockchain interactions
import { PushChain, CONSTANTS, createUniversalSigner, createUniversalAccount } from '@pushchain/devnet';

// Import utility functions from viem
import { hexToBytes } from 'viem';
import { privateKeyToAccount, generatePrivateKey } from 'viem/accounts';

const privateKey = generatePrivateKey(); // Replace it with your private key generation logic
const account = privateKeyToAccount(privateKey);

// Create Signer. Defaults to Ethereum Sepolia
const signer = createUniversalSigner({
  address: account.address,
  signMessage: async (data) =>
    hexToBytes(await account.signMessage({ message: { raw: data } })),
});

const pushChain = await PushChain.initialize(signer);

// Send transaction
const tx = await pushChain.tx.send(
  // We will send the transaction to a Solana address
  [
    createUniversalAccount({
      chain: CONSTANTS.CHAIN.SOLANA,
      chainId: CONSTANTS.CHAIN_ID.SOLANA.DEVNET,
      address: 'ySYrGNLLJSK9hvGGpoxg8TzWfRe8ftBtDSMECtx2eJR',
    }),
  ],
  {
    category: 'MY_CUSTOM_CATEGORY', // Specify the category of the transaction
    // Sample email payload
    data: JSON.stringify({
      title: 'Hello old friend from Solana!',
      message: 'Greetings from Ethereum world.',
    }),
  }
);


// Wait for a short delay to allow the transaction to be processed

// Fetch the Transaction by its hash
const results = await pushChain.tx.get(tx.txHash);
for (const blocks of results.blocks) {
  for (const t of blocks.transactions) {
    console.log('transaction data: ', t.data);
  }
}

Installation

js

# Install Libraries
npm install @pushchain/devnet viem

Note: While this guide uses the viem library for utility functions, you can use other libraries like ethers or any library of your choice.

Quickstart from SDK repos

Testing

Sending Transaction

Best way to understand Push Chain is to interact with it directly. Here is how you can get started: