Class TokenDiscoveryAdminService

constructor

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

  Parameters

  • __namedParameters: { db: B2bDatabase }

  Returns TokenDiscoveryAdminService

Staticinstance

create

• create(
      __namedParameters: {
          address: string;
          chainKey: string;
          decimals: number;
          logoUri?: string | null;
          name: string;
          status?: "ACTIVE" | "DISABLED";
          symbol: string;
      },
  ): Promise<{ ok: true; value: { created: boolean } }>

  Adds the token, DISABLED unless status says otherwise. A symbol taken on the chain retries as SYMBOL:0xabcd, then SYMBOL:<address>; a racing duplicate address inserts nothing.

  Parameters

  • __namedParameters: {
        address: string;
        chainKey: string;
        decimals: number;
        logoUri?: string | null;
        name: string;
        status?: "ACTIVE" | "DISABLED";
        symbol: string;
    }

    • address: string

    • chainKey: string

    • decimals: number

    • OptionallogoUri?: string | null

      The registry's logo, stored as data.logoSource.

    • name: string

    • Optionalstatus?: "ACTIVE" | "DISABLED"

    • symbol: string

  Returns Promise<{ ok: true; value: { created: boolean } }>

linkTransactions

• linkTransactions(
      __namedParameters: { pageSize: number },
  ): Promise<{ ok: true; value: number }>

  Links up to pageSize unlinked EVM rows to the token row of their contract, whatever its status, so enabling a token later needs no relink. Returns how many it linked.

  Parameters

  • __namedParameters: { pageSize: number }

  Returns Promise<{ ok: true; value: number }>

recordLogoFailure

• recordLogoFailure(
      __namedParameters: {
          failure: Omit<TokenLogoFailure, "attempts">;
          id: string;
      },
  ): Promise<{ ok: true; value: { updated: boolean } }>

  Records a failure to mirror the token's logo beside any mirror of an earlier source, counting attempts up while the source stays the same, unless its logoSource moved on meanwhile.

  Parameters

  • __namedParameters: { failure: Omit<TokenLogoFailure, "attempts">; id: string }

  Returns Promise<{ ok: true; value: { updated: boolean } }>

searchUnknownMints

• searchUnknownMints(
      __namedParameters: { pageSize: number },
  ): Promise<{ ok: true; value: UnknownMint[] }>

  EVM contracts our rows name that no token row of their chain holds, newest first.

  Parameters

  • __namedParameters: { pageSize: number }

  Returns Promise<{ ok: true; value: UnknownMint[] }>

searchUnlisted

• searchUnlisted<T extends { address: string; chainKey: string }>(
      __namedParameters: { tokens: T[] },
  ): Promise<{ ok: true; value: T[] }>

  The listed contracts no token row of their chain holds, as given.

  Type Parameters

  • T extends { address: string; chainKey: string }

  Parameters

  • __namedParameters: { tokens: T[] }

  Returns Promise<{ ok: true; value: T[] }>

searchUnmirroredLogos

• searchUnmirroredLogos(
      __namedParameters: { pageSize: number },
  ): Promise<{ ok: true; value: { id: string; logoSource: string }[] }>

  Up to pageSize tokens whose logoSource has no mirror, or a mirror of another URL: tokens some wallet row holds first, then oldest row first. A recorded failure of the current logoSource holds it back: for good, unless it was LOGO_FETCH_FAILED, which is tried again 1 hour after the first failure, 6 hours after the second, then daily.

  Parameters

  • __namedParameters: { pageSize: number }

  Returns Promise<{ ok: true; value: { id: string; logoSource: string }[] }>

updateLogo

• updateLogo(
      __namedParameters: { id: string; logo: TokenLogoMirror },
  ): Promise<{ ok: true; value: { updated: boolean } }>

  Records a mirrored logo on the token, clearing any recorded failure, unless its logoSource moved on meanwhile.

  Parameters

  • __namedParameters: { id: string; logo: TokenLogoMirror }

  Returns Promise<{ ok: true; value: { updated: boolean } }>

updateLogoSources

• updateLogoSources(
      __namedParameters: {
          tokens: { address: string; chainKey: string; logoUri: string }[];
      },
  ): Promise<{ ok: true; value: number }>

  Sets each listed token's data.logoSource where its row holds another, or none. Returns how many rows changed.

  Parameters

  • __namedParameters: { tokens: { address: string; chainKey: string; logoUri: string }[] }

  Returns Promise<{ ok: true; value: number }>