solana/web3.js/src/system-program.js

// @flow

import assert from 'assert';

import {Transaction} from './transaction';
import {PublicKey} from './publickey';

/**
 * Factory class for transactions to interact with the System program
 */
export class SystemProgram {
  /**
   * Public key that identifies the System program
   */
  static get programId(): PublicKey {
    return new PublicKey('0x000000000000000000000000000000000000000000000000000000000000000');
  }

  /**
   * Generate a Transaction that creates a new account
   */
  static createAccount(
    from: PublicKey,
    newAccount: PublicKey,
    tokens: number,
    space: number,
    programId: PublicKey
  ): Transaction {
    const userdata = Buffer.alloc(4 + 8 + 8 + 1 + 32);
    let pos = 0;

    userdata.writeUInt32LE(0, pos); // Create Account instruction
    pos += 4;

    userdata.writeUInt32LE(tokens, pos); // tokens as i64
    pos += 8;

    userdata.writeUInt32LE(space, pos); // space as u64
    pos += 8;

    const programIdBytes = programId.toBuffer();
    programIdBytes.copy(userdata, pos);
    pos += programIdBytes.length;

    assert(pos <= userdata.length);

    return new Transaction({
      fee: 0,
      keys: [from, newAccount],
      programId: SystemProgram.programId,
      userdata,
    });
  }

  /**
   * Generate a Transaction that moves tokens from one account to another
   */
  static move(from: PublicKey, to: PublicKey, amount: number): Transaction {
    const userdata = Buffer.alloc(4 + 8);
    let pos = 0;
    userdata.writeUInt32LE(2, pos); // Move instruction
    pos += 4;

    userdata.writeUInt32LE(amount, pos); // amount as u64
    pos += 8;

    assert(pos === userdata.length);

    return new Transaction({
      fee: 0,
      keys: [from, to],
      programId: SystemProgram.programId,
      userdata,
    });
  }

  /**
   * Generate a Transaction that assigns an account to a program
   */
  static assign(from: PublicKey, programId: PublicKey): Transaction {
    const userdata = Buffer.alloc(4 + 32);
    let pos = 0;

    userdata.writeUInt32LE(1, pos); // Assign instruction
    pos += 4;

    const programIdBytes = programId.toBuffer();
    programIdBytes.copy(userdata, pos);
    pos += programIdBytes.length;

    assert(pos === userdata.length);

    return new Transaction({
      fee: 0,
      keys: [from],
      programId: SystemProgram.programId,
      userdata,
    });
  }
}