Class SolanaNonceAdminService

constructor

• new SolanaNonceAdminService(
      __namedParameters: { db: B2bDatabase },
  ): SolanaNonceAdminService

  Parameters

  • __namedParameters: { db: B2bDatabase }

  Returns SolanaNonceAdminService

Staticinstance

get

• get(__namedParameters: { address: Address }): Promise<SolanaNonce | null>

  Parameters

  • __namedParameters: { address: Address }

  Returns Promise<SolanaNonce | null>

getStats

• getStats(): Promise<{ available: number; total: number }>

  Returns Promise<{ available: number; total: number }>

  tallies of available vs total nonce accounts in the DB

search

• search(
      __namedParameters?: {
          addresses?: Address[];
          lockedBy?: string[];
          page?: number;
          pageSize?: number;
      },
  ): Promise<
      {
          ok: true;
          value: { hasNext: boolean; items: SolanaNonce[]; total: number };
      },
  >

  Ordered by insertion, so paging through stays stable while new accounts are added.

  Parameters

  • __namedParameters: { addresses?: Address[]; lockedBy?: string[]; page?: number; pageSize?: number } = {}

    • Optionaladdresses?: Address[]

    • OptionallockedBy?: string[]

      IDs that locked the nonce

    • Optionalpage?: number

    • OptionalpageSize?: number

  Returns Promise<
      {
          ok: true;
          value: { hasNext: boolean; items: SolanaNonce[]; total: number };
      },
  >

update

• update(
      __namedParameters: {
          address: Address;
          data: { nonce: Nonce | null; status?: "AVAILABLE" };
          expected?: Pick<
              SolanaNonce,
              "status"
              | "nonce"
              | "reservedFor"
              | "lockedBy",
          >;
      },
  ): Promise<
      | { ok: true; value: SolanaNonce }
      | {
          error:
              | ServiceError<"SOLANA_NONCE_NOT_FOUND">
              | ServiceError<"SOLANA_NONCE_CHANGED">;
          ok: false;
      },
  >

  Parameters

  • __namedParameters: {
        address: Address;
        data: { nonce: Nonce | null; status?: "AVAILABLE" };
        expected?: Pick<
            SolanaNonce,
            "status"
            | "nonce"
            | "reservedFor"
            | "lockedBy",
        >;
    }

    • address: Address

    • data: { nonce: Nonce | null; status?: "AVAILABLE" }

      • nonce: Nonce | null

        null takes the account out of use: it is missing on-chain.

      • Optionalstatus?: "AVAILABLE"

        Return the nonce to the pool, dropping its reservation or lock.

    • Optionalexpected?: Pick<SolanaNonce, "status" | "nonce" | "reservedFor" | "lockedBy">

      Compare-and-set: write only while the row still matches this read, so a release or lock that landed after it is never overwritten.

  Returns Promise<
      | { ok: true; value: SolanaNonce }
      | {
          error:
              | ServiceError<"SOLANA_NONCE_NOT_FOUND">
              | ServiceError<"SOLANA_NONCE_CHANGED">;
          ok: false;
      },
  >