Skip to main content
Before we begin our quest lets make sure you have the basics ready so lets set up a basic project, if you have already done this, feel free to move on. If you have not finished step 0 in this tutorial please go back and run through that as we refer back and depend on this step. Now that you have your environment all setup and ready to role, make a new file called tutorial.ts, make sure you are in the examples/classic/transfer folder for the classic version and examples/kit/transfer folder for kit. Don’t forget to start your validator with bun start-validator 
mkdir tutorial && touch tutorial-1.ts
Open that file up in your favorite editor, or AI overlord super virtual reality goggles. Lets make a function called createSwigAccount

​
Example

  • Classic
  • Kit
import {
  Connection,
  Keypair,
  LAMPORTS_PER_SOL,
  Transaction,
  sendAndConfirmTransaction,
} from "@solana/web3.js";

import {
  Actions,
  createEd25519AuthorityInfo,
  findSwigPda,
  getCreateSwigInstruction,
} from "@swig-wallet/classic";

import chalk from "chalk";

async function createSwigAccount(connection: Connection, user: Keypair) {
  try {
    const id = new Uint8Array(32);
    crypto.getRandomValues(id);
    const swigAddress = findSwigPda(id);
    const rootAuthorityInfo = createEd25519AuthorityInfo(user.publicKey);
    const rootActions = Actions.set().manageAuthority().get();

    const createSwigIx = await getCreateSwigInstruction({
      payer: user.publicKey,
      id,
      actions: rootActions,
      authorityInfo: rootAuthorityInfo,
    });

    const transaction = new Transaction().add(createSwigIx);
    const signature = await sendAndConfirmTransaction(connection, transaction, [
      user,
    ]);

    console.log(
      chalk.green("✓ Swig account created at:"),
      chalk.cyan(swigAddress.toBase58()),
    );
    console.log(chalk.blue("Transaction signature:"), chalk.cyan(signature));
    return swigAddress;
  } catch (error) {
    console.error(
      chalk.red("✗ Error creating Swig account:"),
      chalk.red(error),
    );
    throw error;
  }
}

(async () => {
  console.log(chalk.blue("🚀 Starting tutorial"));
  const connection = new Connection("http://localhost:8899", "confirmed");
  const userKeypair = Keypair.generate();
  const f = await connection.requestAirdrop(
    userKeypair.publicKey,
    100 * LAMPORTS_PER_SOL,
  );
  const blockhash = await connection.getLatestBlockhash();
  await connection.confirmTransaction({
    signature: f,
    blockhash: blockhash.blockhash,
    lastValidBlockHeight: blockhash.lastValidBlockHeight,
  });
  console.log(
    chalk.green("👤 User public key:"),
    chalk.cyan(userKeypair.publicKey.toBase58()),
  );
  const swigAddress = await createSwigAccount(connection, userKeypair);
  setTimeout(() => {
    console.log(chalk.green("\n✨ Everything looks good!"));
    console.log(
      chalk.yellow("🔍 Check out your transaction on Solana Explorer:"),
    );
    console.log(
      chalk.cyan(
        `https://explorer.solana.com/address/${swigAddress.toBase58()}?cluster=custom&customUrl=http%3A%2F%2Flocalhost%3A8899`,
      ),
    );
  }, 2000);
})();
Lets save this and get ready to run it, but before we do lets break it down step by step.

​
1. Import Required SDKs

  • Classic
  • Kit
import {
  Connection,
  Keypair,
  LAMPORTS_PER_SOL,
  Transaction,
  sendAndConfirmTransaction,
} from '@solana/web3.js';

import {
  Actions,
  createEd25519AuthorityInfo,
  findSwigPda,
  getCreateSwigInstruction,
} from '@swig-wallet/classic';
Imports Solana primitives and essential utilities from the Swig SDK.

​
2. Generate a Unique Swig ID

  • Classic
  • Kit
const id = new Uint8Array(32);
crypto.getRandomValues(id);
Generates a secure 32-byte ID that uniquely identifies this Swig wallet instance. This ID is used to derive the PDA (Program Derived Address).
💡 This can really be anything, as long as it’s globally unique. You can even use other public keys, strings, or a boring old number if needed.

​
3. Derive the Swig PDA

  • Classic
  • Kit
const [swigAddress] = findSwigPda(id);
Computes the wallet’s on-chain PDA using the generated ID. This is the unique address of the Swig account on Solana.
🧠 This is a standard Solana pattern—Swig just makes it easier.

​
4. Create the Root Role

Swig is role-based: it combines Authorities (who) and Actions (what) to determine permissions. This section builds the root role.
  • Classic
  • Kit
const rootAuthority = createEd25519AuthorityInfo(user.publicKey);
const rootActions = Actions.set().manageAuthority().get();
This sets up the root role. Since this is the root, it must have at least manageAuthority() or all().
✅ manageAuthority() is restrictive but safe. 🚨 all() gives full control—use carefully in production.
You can find all available action types in the Swig SDK docs. New types may be added over time. Swig supports multiple Authority types—this example uses Ed25519 authorities, but others are available for different credentials or verification methods. These handle the Authentication half of Swig’s model. You can find all the types of authorities on the SDK Docs.

​
5. Create the Swig Account On-Chain

  • Classic
  • Kit
const createSwigIx = await getCreateSwigInstruction({
  payer: user.publicKey,
  id,
  actions: rootActions,
  authorityInfo: rootAuthority,
});

const transaction = new Transaction().add(createSwigIx);
const signature = await sendAndConfirmTransaction(connection, transaction, [user]);
Creates the Swig account by building and sending a transaction to the Solana blockchain. The transaction must be signed by the user. In this case the payer of the transaction and the rent is the user, but you can also have a different fee payer for the transaction.

​
6. Simulate a Funded User

  • Classic
  • Kit
const userKeypair = Keypair.generate();
const f = await connection.requestAirdrop(userKeypair.publicKey, 100 * LAMPORTS_PER_SOL);
const blockhash = await connection.getLatestBlockhash();
await connection.confirmTransaction({
  signature: f,
  blockhash: blockhash.blockhash,
  lastValidBlockHeight: blockhash.lastValidBlockHeight,
});
Creates a fresh Keypair and airdrops some SOL from the local validator so it can pay for the transaction.

​
7. Connect to the Validator

  • Classic
  • Kit
const connection = new Connection('http://localhost:8899', 'confirmed');
Creates a connection to the local Solana cluster. Ensure you’ve run:
  • Classic
  • Kit
bun start-validator
This spins up a local testnet with the Swig programs deployed.

​
8. Log Success

  • Classic
  • Kit
console.log(chalk.green("✓ Swig account created at:"), chalk.cyan(swigAddress.toBase58()));
Prints the address of the new Swig account in a colorized format.

​
Ready to run it?

bun run ./tutorial/tutorial-1.ts
Congratulations on your first Swig!
⌘I