@solana/web3.js 1.75.0 → 2.0.0-experimental.20762e0

package/src/utils/send-and-confirm-transaction.ts

@@ -1,98 +0,0 @@
-import {Connection, SignatureResult} from '../connection';
-import {Transaction} from '../transaction';
-import type {ConfirmOptions} from '../connection';
-import type {Signer} from '../keypair';
-import type {TransactionSignature} from '../transaction';
-
-/**
- * Sign, send and confirm a transaction.
- *
- * If `commitment` option is not specified, defaults to 'max' commitment.
- *
- * @param {Connection} connection
- * @param {Transaction} transaction
- * @param {Array<Signer>} signers
- * @param {ConfirmOptions} [options]
- * @returns {Promise<TransactionSignature>}
- */
-export async function sendAndConfirmTransaction(
-  connection: Connection,
-  transaction: Transaction,
-  signers: Array<Signer>,
-  options?: ConfirmOptions &
-    Readonly<{
-      // A signal that, when aborted, cancels any outstanding transaction confirmation operations
-      abortSignal?: AbortSignal;
-    }>,
-): Promise<TransactionSignature> {
-  const sendOptions = options && {
-    skipPreflight: options.skipPreflight,
-    preflightCommitment: options.preflightCommitment || options.commitment,
-    maxRetries: options.maxRetries,
-    minContextSlot: options.minContextSlot,
-  };
-
-  const signature = await connection.sendTransaction(
-    transaction,
-    signers,
-    sendOptions,
-  );
-
-  let status: SignatureResult;
-  if (
-    transaction.recentBlockhash != null &&
-    transaction.lastValidBlockHeight != null
-  ) {
-    status = (
-      await connection.confirmTransaction(
-        {
-          abortSignal: options?.abortSignal,
-          signature: signature,
-          blockhash: transaction.recentBlockhash,
-          lastValidBlockHeight: transaction.lastValidBlockHeight,
-        },
-        options && options.commitment,
-      )
-    ).value;
-  } else if (
-    transaction.minNonceContextSlot != null &&
-    transaction.nonceInfo != null
-  ) {
-    const {nonceInstruction} = transaction.nonceInfo;
-    const nonceAccountPubkey = nonceInstruction.keys[0].pubkey;
-    status = (
-      await connection.confirmTransaction(
-        {
-          abortSignal: options?.abortSignal,
-          minContextSlot: transaction.minNonceContextSlot,
-          nonceAccountPubkey,
-          nonceValue: transaction.nonceInfo.nonce,
-          signature,
-        },
-        options && options.commitment,
-      )
-    ).value;
-  } else {
-    if (options?.abortSignal != null) {
-      console.warn(
-        'sendAndConfirmTransaction(): A transaction with a deprecated confirmation strategy was ' +
-          'supplied along with an `abortSignal`. Only transactions having `lastValidBlockHeight` ' +
-          'or a combination of `nonceInfo` and `minNonceContextSlot` are abortable.',
-      );
-    }
-    status = (
-      await connection.confirmTransaction(
-        signature,
-        options && options.commitment,
-      )
-    ).value;
-  }
-
-  if (status.err) {
-    throw new Error(
-      `Transaction ${signature} failed (${JSON.stringify(status)})`,
-    );
-  }
-
-  return signature;
-}

package/src/utils/shortvec-encoding.ts

@@ -1,28 +0,0 @@
-export function decodeLength(bytes: Array<number>): number {
-  let len = 0;
-  let size = 0;
-  for (;;) {
-    let elem = bytes.shift() as number;
-    len |= (elem & 0x7f) << (size * 7);
-    size += 1;
-    if ((elem & 0x80) === 0) {
-      break;
-    }
-  }
-  return len;
-}
-
-export function encodeLength(bytes: Array<number>, len: number) {
-  let rem_len = len;
-  for (;;) {
-    let elem = rem_len & 0x7f;
-    rem_len >>= 7;
-    if (rem_len == 0) {
-      bytes.push(elem);
-      break;
-    } else {
-      elem |= 0x80;
-      bytes.push(elem);
-    }
-  }
-}

package/src/utils/sleep.ts

@@ -1,4 +0,0 @@
-// zzz
-export function sleep(ms: number): Promise<void> {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}

package/src/utils/to-buffer.ts

@@ -1,11 +0,0 @@
-import {Buffer} from 'buffer';
-
-export const toBuffer = (arr: Buffer | Uint8Array | Array<number>): Buffer => {
-  if (Buffer.isBuffer(arr)) {
-    return arr;
-  } else if (arr instanceof Uint8Array) {
-    return Buffer.from(arr.buffer, arr.byteOffset, arr.byteLength);
-  } else {
-    return Buffer.from(arr);
-  }
-};

package/src/validator-info.ts

@@ -1,104 +0,0 @@
-import {Buffer} from 'buffer';
-import {
-  assert as assertType,
-  optional,
-  string,
-  type as pick,
-} from 'superstruct';
-
-import * as Layout from './layout';
-import * as shortvec from './utils/shortvec-encoding';
-import {PublicKey, PUBLIC_KEY_LENGTH} from './publickey';
-
-export const VALIDATOR_INFO_KEY = new PublicKey(
-  'Va1idator1nfo111111111111111111111111111111',
-);
-
-/**
- * @internal
- */
-type ConfigKey = {
-  publicKey: PublicKey;
-  isSigner: boolean;
-};
-
-/**
- * Info used to identity validators.
- */
-export type Info = {
-  /** validator name */
-  name: string;
-  /** optional, validator website */
-  website?: string;
-  /** optional, extra information the validator chose to share */
-  details?: string;
-  /** optional, used to identify validators on keybase.io */
-  keybaseUsername?: string;
-};
-
-const InfoString = pick({
-  name: string(),
-  website: optional(string()),
-  details: optional(string()),
-  keybaseUsername: optional(string()),
-});
-
-/**
- * ValidatorInfo class
- */
-export class ValidatorInfo {
-  /**
-   * validator public key
-   */
-  key: PublicKey;
-  /**
-   * validator information
-   */
-  info: Info;
-
-  /**
-   * Construct a valid ValidatorInfo
-   *
-   * @param key validator public key
-   * @param info validator information
-   */
-  constructor(key: PublicKey, info: Info) {
-    this.key = key;
-    this.info = info;
-  }
-
-  /**
-   * Deserialize ValidatorInfo from the config account data. Exactly two config
-   * keys are required in the data.
-   *
-   * @param buffer config account data
-   * @return null if info was not found
-   */
-  static fromConfigData(
-    buffer: Buffer | Uint8Array | Array<number>,
-  ): ValidatorInfo | null {
-    let byteArray = [...buffer];
-    const configKeyCount = shortvec.decodeLength(byteArray);
-    if (configKeyCount !== 2) return null;
-
-    const configKeys: Array<ConfigKey> = [];
-    for (let i = 0; i < 2; i++) {
-      const publicKey = new PublicKey(byteArray.slice(0, PUBLIC_KEY_LENGTH));
-      byteArray = byteArray.slice(PUBLIC_KEY_LENGTH);
-      const isSigner = byteArray.slice(0, 1)[0] === 1;
-      byteArray = byteArray.slice(1);
-      configKeys.push({publicKey, isSigner});
-    }
-
-    if (configKeys[0].publicKey.equals(VALIDATOR_INFO_KEY)) {
-      if (configKeys[1].isSigner) {
-        const rawInfo: any = Layout.rustString().decode(Buffer.from(byteArray));
-        const info = JSON.parse(rawInfo as string);
-        assertType(info, InfoString);
-        return new ValidatorInfo(configKeys[1].publicKey, info);
-      }
-    }
-
-    return null;
-  }
-}

package/src/vote-account.ts

@@ -1,236 +0,0 @@
-import * as BufferLayout from '@solana/buffer-layout';
-import type {Buffer} from 'buffer';
-
-import * as Layout from './layout';
-import {PublicKey} from './publickey';
-import {toBuffer} from './utils/to-buffer';
-
-export const VOTE_PROGRAM_ID = new PublicKey(
-  'Vote111111111111111111111111111111111111111',
-);
-
-export type Lockout = {
-  slot: number;
-  confirmationCount: number;
-};
-
-/**
- * History of how many credits earned by the end of each epoch
- */
-export type EpochCredits = Readonly<{
-  epoch: number;
-  credits: number;
-  prevCredits: number;
-}>;
-
-export type AuthorizedVoter = Readonly<{
-  epoch: number;
-  authorizedVoter: PublicKey;
-}>;
-
-type AuthorizedVoterRaw = Readonly<{
-  authorizedVoter: Uint8Array;
-  epoch: number;
-}>;
-
-type PriorVoters = Readonly<{
-  buf: PriorVoterRaw[];
-  idx: number;
-  isEmpty: number;
-}>;
-
-export type PriorVoter = Readonly<{
-  authorizedPubkey: PublicKey;
-  epochOfLastAuthorizedSwitch: number;
-  targetEpoch: number;
-}>;
-
-type PriorVoterRaw = Readonly<{
-  authorizedPubkey: Uint8Array;
-  epochOfLastAuthorizedSwitch: number;
-  targetEpoch: number;
-}>;
-
-export type BlockTimestamp = Readonly<{
-  slot: number;
-  timestamp: number;
-}>;
-
-type VoteAccountData = Readonly<{
-  authorizedVoters: AuthorizedVoterRaw[];
-  authorizedWithdrawer: Uint8Array;
-  commission: number;
-  epochCredits: EpochCredits[];
-  lastTimestamp: BlockTimestamp;
-  nodePubkey: Uint8Array;
-  priorVoters: PriorVoters;
-  rootSlot: number;
-  rootSlotValid: number;
-  votes: Lockout[];
-}>;
-
-/**
- * See https://github.com/solana-labs/solana/blob/8a12ed029cfa38d4a45400916c2463fb82bbec8c/programs/vote_api/src/vote_state.rs#L68-L88
- *
- * @internal
- */
-const VoteAccountLayout = BufferLayout.struct<VoteAccountData>([
-  Layout.publicKey('nodePubkey'),
-  Layout.publicKey('authorizedWithdrawer'),
-  BufferLayout.u8('commission'),
-  BufferLayout.nu64(), // votes.length
-  BufferLayout.seq<Lockout>(
-    BufferLayout.struct([
-      BufferLayout.nu64('slot'),
-      BufferLayout.u32('confirmationCount'),
-    ]),
-    BufferLayout.offset(BufferLayout.u32(), -8),
-    'votes',
-  ),
-  BufferLayout.u8('rootSlotValid'),
-  BufferLayout.nu64('rootSlot'),
-  BufferLayout.nu64(), // authorizedVoters.length
-  BufferLayout.seq<AuthorizedVoterRaw>(
-    BufferLayout.struct([
-      BufferLayout.nu64('epoch'),
-      Layout.publicKey('authorizedVoter'),
-    ]),
-    BufferLayout.offset(BufferLayout.u32(), -8),
-    'authorizedVoters',
-  ),
-  BufferLayout.struct<PriorVoters>(
-    [
-      BufferLayout.seq(
-        BufferLayout.struct([
-          Layout.publicKey('authorizedPubkey'),
-          BufferLayout.nu64('epochOfLastAuthorizedSwitch'),
-          BufferLayout.nu64('targetEpoch'),
-        ]),
-        32,
-        'buf',
-      ),
-      BufferLayout.nu64('idx'),
-      BufferLayout.u8('isEmpty'),
-    ],
-    'priorVoters',
-  ),
-  BufferLayout.nu64(), // epochCredits.length
-  BufferLayout.seq<EpochCredits>(
-    BufferLayout.struct([
-      BufferLayout.nu64('epoch'),
-      BufferLayout.nu64('credits'),
-      BufferLayout.nu64('prevCredits'),
-    ]),
-    BufferLayout.offset(BufferLayout.u32(), -8),
-    'epochCredits',
-  ),
-  BufferLayout.struct<BlockTimestamp>(
-    [BufferLayout.nu64('slot'), BufferLayout.nu64('timestamp')],
-    'lastTimestamp',
-  ),
-]);
-
-type VoteAccountArgs = {
-  nodePubkey: PublicKey;
-  authorizedWithdrawer: PublicKey;
-  commission: number;
-  rootSlot: number | null;
-  votes: Lockout[];
-  authorizedVoters: AuthorizedVoter[];
-  priorVoters: PriorVoter[];
-  epochCredits: EpochCredits[];
-  lastTimestamp: BlockTimestamp;
-};
-
-/**
- * VoteAccount class
- */
-export class VoteAccount {
-  nodePubkey: PublicKey;
-  authorizedWithdrawer: PublicKey;
-  commission: number;
-  rootSlot: number | null;
-  votes: Lockout[];
-  authorizedVoters: AuthorizedVoter[];
-  priorVoters: PriorVoter[];
-  epochCredits: EpochCredits[];
-  lastTimestamp: BlockTimestamp;
-
-  /**
-   * @internal
-   */
-  constructor(args: VoteAccountArgs) {
-    this.nodePubkey = args.nodePubkey;
-    this.authorizedWithdrawer = args.authorizedWithdrawer;
-    this.commission = args.commission;
-    this.rootSlot = args.rootSlot;
-    this.votes = args.votes;
-    this.authorizedVoters = args.authorizedVoters;
-    this.priorVoters = args.priorVoters;
-    this.epochCredits = args.epochCredits;
-    this.lastTimestamp = args.lastTimestamp;
-  }
-
-  /**
-   * Deserialize VoteAccount from the account data.
-   *
-   * @param buffer account data
-   * @return VoteAccount
-   */
-  static fromAccountData(
-    buffer: Buffer | Uint8Array | Array<number>,
-  ): VoteAccount {
-    const versionOffset = 4;
-    const va = VoteAccountLayout.decode(toBuffer(buffer), versionOffset);
-
-    let rootSlot: number | null = va.rootSlot;
-    if (!va.rootSlotValid) {
-      rootSlot = null;
-    }
-
-    return new VoteAccount({
-      nodePubkey: new PublicKey(va.nodePubkey),
-      authorizedWithdrawer: new PublicKey(va.authorizedWithdrawer),
-      commission: va.commission,
-      votes: va.votes,
-      rootSlot,
-      authorizedVoters: va.authorizedVoters.map(parseAuthorizedVoter),
-      priorVoters: getPriorVoters(va.priorVoters),
-      epochCredits: va.epochCredits,
-      lastTimestamp: va.lastTimestamp,
-    });
-  }
-}
-
-function parseAuthorizedVoter({
-  authorizedVoter,
-  epoch,
-}: AuthorizedVoterRaw): AuthorizedVoter {
-  return {
-    epoch,
-    authorizedVoter: new PublicKey(authorizedVoter),
-  };
-}
-
-function parsePriorVoters({
-  authorizedPubkey,
-  epochOfLastAuthorizedSwitch,
-  targetEpoch,
-}: PriorVoterRaw): PriorVoter {
-  return {
-    authorizedPubkey: new PublicKey(authorizedPubkey),
-    epochOfLastAuthorizedSwitch,
-    targetEpoch,
-  };
-}
-
-function getPriorVoters({buf, idx, isEmpty}: PriorVoters): PriorVoter[] {
-  if (isEmpty) {
-    return [];
-  }
-
-  return [
-    ...buf.slice(idx + 1).map(parsePriorVoters),
-    ...buf.slice(0, idx).map(parsePriorVoters),
-  ];
-}