@junobuild/admin 0.0.12 → 0.0.14

package/declarations/internet_identity/internet_identity.did.d.ts

@@ -0,0 +1,204 @@
+import type {ActorMethod} from '@dfinity/agent';
+import type {Principal} from '@dfinity/principal';
+
+export interface ActiveAnchorCounter {
+  counter: bigint;
+  start_timestamp: Timestamp;
+}
+export interface ActiveAnchorStatistics {
+  completed: CompletedActiveAnchorStats;
+  ongoing: OngoingActiveAnchorStats;
+}
+export type AddTentativeDeviceResponse =
+  | {
+      device_registration_mode_off: null;
+    }
+  | {another_device_tentatively_added: null}
+  | {
+      added_tentatively: {
+        verification_code: string;
+        device_registration_timeout: Timestamp;
+      };
+    };
+export interface AnchorCredentials {
+  recovery_phrases: Array<PublicKey>;
+  credentials: Array<WebAuthnCredential>;
+  recovery_credentials: Array<WebAuthnCredential>;
+}
+export interface ArchiveConfig {
+  polling_interval_ns: bigint;
+  entries_buffer_limit: bigint;
+  module_hash: Uint8Array | number[];
+  entries_fetch_limit: number;
+}
+export interface ArchiveInfo {
+  archive_config: [] | [ArchiveConfig];
+  archive_canister: [] | [Principal];
+}
+export interface BufferedArchiveEntry {
+  sequence_number: bigint;
+  entry: Uint8Array | number[];
+  anchor_number: UserNumber;
+  timestamp: Timestamp;
+}
+export interface Challenge {
+  png_base64: string;
+  challenge_key: ChallengeKey;
+}
+export type ChallengeKey = string;
+export interface ChallengeResult {
+  key: ChallengeKey;
+  chars: string;
+}
+export interface CompletedActiveAnchorStats {
+  monthly_active_anchors: [] | [ActiveAnchorCounter];
+  daily_active_anchors: [] | [ActiveAnchorCounter];
+}
+export type CredentialId = Uint8Array | number[];
+export interface Delegation {
+  pubkey: PublicKey;
+  targets: [] | [Array<Principal>];
+  expiration: Timestamp;
+}
+export type DeployArchiveResult =
+  | {creation_in_progress: null}
+  | {success: Principal}
+  | {failed: string};
+export interface DeviceData {
+  alias: string;
+  origin: [] | [string];
+  protection: DeviceProtection;
+  pubkey: DeviceKey;
+  key_type: KeyType;
+  purpose: Purpose;
+  credential_id: [] | [CredentialId];
+}
+export type DeviceKey = PublicKey;
+export type DeviceProtection = {unprotected: null} | {protected: null};
+export interface DeviceRegistrationInfo {
+  tentative_device: [] | [DeviceData];
+  expiration: Timestamp;
+}
+export interface DeviceWithUsage {
+  alias: string;
+  last_usage: [] | [Timestamp];
+  origin: [] | [string];
+  protection: DeviceProtection;
+  pubkey: DeviceKey;
+  key_type: KeyType;
+  purpose: Purpose;
+  credential_id: [] | [CredentialId];
+}
+export type FrontendHostname = string;
+export type GetDelegationResponse =
+  | {no_such_delegation: null}
+  | {signed_delegation: SignedDelegation};
+export type HeaderField = [string, string];
+export interface HttpRequest {
+  url: string;
+  method: string;
+  body: Uint8Array | number[];
+  headers: Array<HeaderField>;
+}
+export interface HttpResponse {
+  body: Uint8Array | number[];
+  headers: Array<HeaderField>;
+  upgrade: [] | [boolean];
+  streaming_strategy: [] | [StreamingStrategy];
+  status_code: number;
+}
+export interface IdentityAnchorInfo {
+  devices: Array<DeviceWithUsage>;
+  device_registration: [] | [DeviceRegistrationInfo];
+}
+export interface InternetIdentityInit {
+  assigned_user_number_range: [] | [[bigint, bigint]];
+  archive_config: [] | [ArchiveConfig];
+  canister_creation_cycles_cost: [] | [bigint];
+  register_rate_limit: [] | [RateLimitConfig];
+}
+export interface InternetIdentityStats {
+  storage_layout_version: number;
+  users_registered: bigint;
+  assigned_user_number_range: [bigint, bigint];
+  archive_info: ArchiveInfo;
+  canister_creation_cycles_cost: bigint;
+  active_anchor_stats: [] | [ActiveAnchorStatistics];
+}
+export type KeyType =
+  | {platform: null}
+  | {seed_phrase: null}
+  | {cross_platform: null}
+  | {unknown: null};
+export interface OngoingActiveAnchorStats {
+  monthly_active_anchors: Array<ActiveAnchorCounter>;
+  daily_active_anchors: ActiveAnchorCounter;
+}
+export type PublicKey = Uint8Array | number[];
+export type Purpose = {authentication: null} | {recovery: null};
+export interface RateLimitConfig {
+  max_tokens: bigint;
+  time_per_token_ns: bigint;
+}
+export type RegisterResponse =
+  | {bad_challenge: null}
+  | {canister_full: null}
+  | {registered: {user_number: UserNumber}};
+export type SessionKey = PublicKey;
+export interface SignedDelegation {
+  signature: Uint8Array | number[];
+  delegation: Delegation;
+}
+export interface StreamingCallbackHttpResponse {
+  token: [] | [Token];
+  body: Uint8Array | number[];
+}
+export type StreamingStrategy = {
+  Callback: {token: Token; callback: [Principal, string]};
+};
+export type Timestamp = bigint;
+export type Token = {};
+export type UserKey = PublicKey;
+export type UserNumber = bigint;
+export type VerifyTentativeDeviceResponse =
+  | {
+      device_registration_mode_off: null;
+    }
+  | {verified: null}
+  | {wrong_code: {retries_left: number}}
+  | {no_device_to_verify: null};
+export interface WebAuthnCredential {
+  pubkey: PublicKey;
+  credential_id: CredentialId;
+}
+export interface _SERVICE {
+  acknowledge_entries: ActorMethod<[bigint], undefined>;
+  add: ActorMethod<[UserNumber, DeviceData], undefined>;
+  add_tentative_device: ActorMethod<[UserNumber, DeviceData], AddTentativeDeviceResponse>;
+  create_challenge: ActorMethod<[], Challenge>;
+  deploy_archive: ActorMethod<[Uint8Array | number[]], DeployArchiveResult>;
+  enter_device_registration_mode: ActorMethod<[UserNumber], Timestamp>;
+  exit_device_registration_mode: ActorMethod<[UserNumber], undefined>;
+  fetch_entries: ActorMethod<[], Array<BufferedArchiveEntry>>;
+  get_anchor_credentials: ActorMethod<[UserNumber], AnchorCredentials>;
+  get_anchor_info: ActorMethod<[UserNumber], IdentityAnchorInfo>;
+  get_delegation: ActorMethod<
+    [UserNumber, FrontendHostname, SessionKey, Timestamp],
+    GetDelegationResponse
+  >;
+  get_principal: ActorMethod<[UserNumber, FrontendHostname], Principal>;
+  http_request: ActorMethod<[HttpRequest], HttpResponse>;
+  http_request_update: ActorMethod<[HttpRequest], HttpResponse>;
+  init_salt: ActorMethod<[], undefined>;
+  lookup: ActorMethod<[UserNumber], Array<DeviceData>>;
+  prepare_delegation: ActorMethod<
+    [UserNumber, FrontendHostname, SessionKey, [] | [bigint]],
+    [UserKey, Timestamp]
+  >;
+  register: ActorMethod<[DeviceData, ChallengeResult], RegisterResponse>;
+  remove: ActorMethod<[UserNumber, DeviceKey], undefined>;
+  replace: ActorMethod<[UserNumber, DeviceKey, DeviceData], undefined>;
+  stats: ActorMethod<[], InternetIdentityStats>;
+  update: ActorMethod<[UserNumber, DeviceKey, DeviceData], undefined>;
+  verify_tentative_device: ActorMethod<[UserNumber, string], VerifyTentativeDeviceResponse>;
+}

package/declarations/internet_identity/internet_identity.factory.did.js

@@ -0,0 +1,233 @@
+export const idlFactory = ({IDL}) => {
+  const ArchiveConfig = IDL.Record({
+    polling_interval_ns: IDL.Nat64,
+    entries_buffer_limit: IDL.Nat64,
+    module_hash: IDL.Vec(IDL.Nat8),
+    entries_fetch_limit: IDL.Nat16
+  });
+  const RateLimitConfig = IDL.Record({
+    max_tokens: IDL.Nat64,
+    time_per_token_ns: IDL.Nat64
+  });
+  const InternetIdentityInit = IDL.Record({
+    assigned_user_number_range: IDL.Opt(IDL.Tuple(IDL.Nat64, IDL.Nat64)),
+    archive_config: IDL.Opt(ArchiveConfig),
+    canister_creation_cycles_cost: IDL.Opt(IDL.Nat64),
+    register_rate_limit: IDL.Opt(RateLimitConfig)
+  });
+  const UserNumber = IDL.Nat64;
+  const DeviceProtection = IDL.Variant({
+    unprotected: IDL.Null,
+    protected: IDL.Null
+  });
+  const PublicKey = IDL.Vec(IDL.Nat8);
+  const DeviceKey = PublicKey;
+  const KeyType = IDL.Variant({
+    platform: IDL.Null,
+    seed_phrase: IDL.Null,
+    cross_platform: IDL.Null,
+    unknown: IDL.Null
+  });
+  const Purpose = IDL.Variant({
+    authentication: IDL.Null,
+    recovery: IDL.Null
+  });
+  const CredentialId = IDL.Vec(IDL.Nat8);
+  const DeviceData = IDL.Record({
+    alias: IDL.Text,
+    origin: IDL.Opt(IDL.Text),
+    protection: DeviceProtection,
+    pubkey: DeviceKey,
+    key_type: KeyType,
+    purpose: Purpose,
+    credential_id: IDL.Opt(CredentialId)
+  });
+  const Timestamp = IDL.Nat64;
+  const AddTentativeDeviceResponse = IDL.Variant({
+    device_registration_mode_off: IDL.Null,
+    another_device_tentatively_added: IDL.Null,
+    added_tentatively: IDL.Record({
+      verification_code: IDL.Text,
+      device_registration_timeout: Timestamp
+    })
+  });
+  const ChallengeKey = IDL.Text;
+  const Challenge = IDL.Record({
+    png_base64: IDL.Text,
+    challenge_key: ChallengeKey
+  });
+  const DeployArchiveResult = IDL.Variant({
+    creation_in_progress: IDL.Null,
+    success: IDL.Principal,
+    failed: IDL.Text
+  });
+  const BufferedArchiveEntry = IDL.Record({
+    sequence_number: IDL.Nat64,
+    entry: IDL.Vec(IDL.Nat8),
+    anchor_number: UserNumber,
+    timestamp: Timestamp
+  });
+  const WebAuthnCredential = IDL.Record({
+    pubkey: PublicKey,
+    credential_id: CredentialId
+  });
+  const AnchorCredentials = IDL.Record({
+    recovery_phrases: IDL.Vec(PublicKey),
+    credentials: IDL.Vec(WebAuthnCredential),
+    recovery_credentials: IDL.Vec(WebAuthnCredential)
+  });
+  const DeviceWithUsage = IDL.Record({
+    alias: IDL.Text,
+    last_usage: IDL.Opt(Timestamp),
+    origin: IDL.Opt(IDL.Text),
+    protection: DeviceProtection,
+    pubkey: DeviceKey,
+    key_type: KeyType,
+    purpose: Purpose,
+    credential_id: IDL.Opt(CredentialId)
+  });
+  const DeviceRegistrationInfo = IDL.Record({
+    tentative_device: IDL.Opt(DeviceData),
+    expiration: Timestamp
+  });
+  const IdentityAnchorInfo = IDL.Record({
+    devices: IDL.Vec(DeviceWithUsage),
+    device_registration: IDL.Opt(DeviceRegistrationInfo)
+  });
+  const FrontendHostname = IDL.Text;
+  const SessionKey = PublicKey;
+  const Delegation = IDL.Record({
+    pubkey: PublicKey,
+    targets: IDL.Opt(IDL.Vec(IDL.Principal)),
+    expiration: Timestamp
+  });
+  const SignedDelegation = IDL.Record({
+    signature: IDL.Vec(IDL.Nat8),
+    delegation: Delegation
+  });
+  const GetDelegationResponse = IDL.Variant({
+    no_such_delegation: IDL.Null,
+    signed_delegation: SignedDelegation
+  });
+  const HeaderField = IDL.Tuple(IDL.Text, IDL.Text);
+  const HttpRequest = IDL.Record({
+    url: IDL.Text,
+    method: IDL.Text,
+    body: IDL.Vec(IDL.Nat8),
+    headers: IDL.Vec(HeaderField)
+  });
+  const Token = IDL.Record({});
+  const StreamingCallbackHttpResponse = IDL.Record({
+    token: IDL.Opt(Token),
+    body: IDL.Vec(IDL.Nat8)
+  });
+  const StreamingStrategy = IDL.Variant({
+    Callback: IDL.Record({
+      token: Token,
+      callback: IDL.Func([Token], [StreamingCallbackHttpResponse], ['query'])
+    })
+  });
+  const HttpResponse = IDL.Record({
+    body: IDL.Vec(IDL.Nat8),
+    headers: IDL.Vec(HeaderField),
+    upgrade: IDL.Opt(IDL.Bool),
+    streaming_strategy: IDL.Opt(StreamingStrategy),
+    status_code: IDL.Nat16
+  });
+  const UserKey = PublicKey;
+  const ChallengeResult = IDL.Record({
+    key: ChallengeKey,
+    chars: IDL.Text
+  });
+  const RegisterResponse = IDL.Variant({
+    bad_challenge: IDL.Null,
+    canister_full: IDL.Null,
+    registered: IDL.Record({user_number: UserNumber})
+  });
+  const ArchiveInfo = IDL.Record({
+    archive_config: IDL.Opt(ArchiveConfig),
+    archive_canister: IDL.Opt(IDL.Principal)
+  });
+  const ActiveAnchorCounter = IDL.Record({
+    counter: IDL.Nat64,
+    start_timestamp: Timestamp
+  });
+  const CompletedActiveAnchorStats = IDL.Record({
+    monthly_active_anchors: IDL.Opt(ActiveAnchorCounter),
+    daily_active_anchors: IDL.Opt(ActiveAnchorCounter)
+  });
+  const OngoingActiveAnchorStats = IDL.Record({
+    monthly_active_anchors: IDL.Vec(ActiveAnchorCounter),
+    daily_active_anchors: ActiveAnchorCounter
+  });
+  const ActiveAnchorStatistics = IDL.Record({
+    completed: CompletedActiveAnchorStats,
+    ongoing: OngoingActiveAnchorStats
+  });
+  const InternetIdentityStats = IDL.Record({
+    storage_layout_version: IDL.Nat8,
+    users_registered: IDL.Nat64,
+    assigned_user_number_range: IDL.Tuple(IDL.Nat64, IDL.Nat64),
+    archive_info: ArchiveInfo,
+    canister_creation_cycles_cost: IDL.Nat64,
+    active_anchor_stats: IDL.Opt(ActiveAnchorStatistics)
+  });
+  const VerifyTentativeDeviceResponse = IDL.Variant({
+    device_registration_mode_off: IDL.Null,
+    verified: IDL.Null,
+    wrong_code: IDL.Record({retries_left: IDL.Nat8}),
+    no_device_to_verify: IDL.Null
+  });
+  return IDL.Service({
+    acknowledge_entries: IDL.Func([IDL.Nat64], [], []),
+    add: IDL.Func([UserNumber, DeviceData], [], []),
+    add_tentative_device: IDL.Func([UserNumber, DeviceData], [AddTentativeDeviceResponse], []),
+    create_challenge: IDL.Func([], [Challenge], []),
+    deploy_archive: IDL.Func([IDL.Vec(IDL.Nat8)], [DeployArchiveResult], []),
+    enter_device_registration_mode: IDL.Func([UserNumber], [Timestamp], []),
+    exit_device_registration_mode: IDL.Func([UserNumber], [], []),
+    fetch_entries: IDL.Func([], [IDL.Vec(BufferedArchiveEntry)], []),
+    get_anchor_credentials: IDL.Func([UserNumber], [AnchorCredentials], ['query']),
+    get_anchor_info: IDL.Func([UserNumber], [IdentityAnchorInfo], []),
+    get_delegation: IDL.Func(
+      [UserNumber, FrontendHostname, SessionKey, Timestamp],
+      [GetDelegationResponse],
+      ['query']
+    ),
+    get_principal: IDL.Func([UserNumber, FrontendHostname], [IDL.Principal], ['query']),
+    http_request: IDL.Func([HttpRequest], [HttpResponse], ['query']),
+    http_request_update: IDL.Func([HttpRequest], [HttpResponse], []),
+    init_salt: IDL.Func([], [], []),
+    lookup: IDL.Func([UserNumber], [IDL.Vec(DeviceData)], ['query']),
+    prepare_delegation: IDL.Func(
+      [UserNumber, FrontendHostname, SessionKey, IDL.Opt(IDL.Nat64)],
+      [UserKey, Timestamp],
+      []
+    ),
+    register: IDL.Func([DeviceData, ChallengeResult], [RegisterResponse], []),
+    remove: IDL.Func([UserNumber, DeviceKey], [], []),
+    replace: IDL.Func([UserNumber, DeviceKey, DeviceData], [], []),
+    stats: IDL.Func([], [InternetIdentityStats], ['query']),
+    update: IDL.Func([UserNumber, DeviceKey, DeviceData], [], []),
+    verify_tentative_device: IDL.Func([UserNumber, IDL.Text], [VerifyTentativeDeviceResponse], [])
+  });
+};
+export const init = ({IDL}) => {
+  const ArchiveConfig = IDL.Record({
+    polling_interval_ns: IDL.Nat64,
+    entries_buffer_limit: IDL.Nat64,
+    module_hash: IDL.Vec(IDL.Nat8),
+    entries_fetch_limit: IDL.Nat16
+  });
+  const RateLimitConfig = IDL.Record({
+    max_tokens: IDL.Nat64,
+    time_per_token_ns: IDL.Nat64
+  });
+  const InternetIdentityInit = IDL.Record({
+    assigned_user_number_range: IDL.Opt(IDL.Tuple(IDL.Nat64, IDL.Nat64)),
+    archive_config: IDL.Opt(ArchiveConfig),
+    canister_creation_cycles_cost: IDL.Opt(IDL.Nat64),
+    register_rate_limit: IDL.Opt(RateLimitConfig)
+  });
+  return [IDL.Opt(InternetIdentityInit)];
+};

package/declarations/ledger/index.d.ts

@@ -0,0 +1,45 @@
+import type {ActorConfig, ActorSubclass, Agent, HttpAgentOptions} from '@dfinity/agent';
+import type {IDL} from '@dfinity/candid';
+import type {Principal} from '@dfinity/principal';
+
+import {_SERVICE} from './ledger.did';
+
+export declare const idlFactory: IDL.InterfaceFactory;
+export declare const canisterId: string;
+
+export declare interface CreateActorOptions {
+  /**
+   * @see {@link Agent}
+   */
+  agent?: Agent;
+  /**
+   * @see {@link HttpAgentOptions}
+   */
+  agentOptions?: HttpAgentOptions;
+  /**
+   * @see {@link ActorConfig}
+   */
+  actorOptions?: ActorConfig;
+}
+
+/**
+ * Intializes an {@link ActorSubclass}, configured with the provided SERVICE interface of a canister.
+ * @constructs {@link ActorSubClass}
+ * @param {string | Principal} canisterId - ID of the canister the {@link Actor} will talk to
+ * @param {CreateActorOptions} options - see {@link CreateActorOptions}
+ * @param {CreateActorOptions["agent"]} options.agent - a pre-configured agent you'd like to use. Supercedes agentOptions
+ * @param {CreateActorOptions["agentOptions"]} options.agentOptions - options to set up a new agent
+ * @see {@link HttpAgentOptions}
+ * @param {CreateActorOptions["actorOptions"]} options.actorOptions - options for the Actor
+ * @see {@link ActorConfig}
+ */
+export declare const createActor: (
+  canisterId: string | Principal,
+  options?: CreateActorOptions
+) => ActorSubclass<_SERVICE>;
+
+/**
+ * Intialized Actor using default settings, ready to talk to a canister using its candid interface
+ * @constructs {@link ActorSubClass}
+ */
+export declare const ledger: ActorSubclass<_SERVICE>;

package/declarations/ledger/index.js

@@ -0,0 +1,32 @@
+import {Actor, HttpAgent} from '@dfinity/agent';
+
+// Imports and re-exports candid interface
+import {idlFactory} from './ledger.did.js';
+export {idlFactory} from './ledger.did.js';
+
+// CANISTER_ID is replaced by webpack based on node environment
+
+export const createActor = (canisterId, options = {}) => {
+  const agent = options.agent || new HttpAgent({...options.agentOptions});
+
+  if (options.agent && options.agentOptions) {
+    console.warn(
+      'Detected both agent and agentOptions passed to createActor. Ignoring agentOptions and proceeding with the provided agent.'
+    );
+  }
+
+  // Fetch root key for certificate validation during development
+  if (process.env.DFX_NETWORK !== 'ic') {
+    agent.fetchRootKey().catch((err) => {
+      console.warn('Unable to fetch root key. Check to ensure that your local replica is running');
+      console.error(err);
+    });
+  }
+
+  // Creates an actor with using the candid interface and the HttpAgent
+  return Actor.createActor(idlFactory, {
+    agent,
+    canisterId,
+    ...options.actorOptions
+  });
+};