@aeternity/aepp-sdk 10.0.0 → 12.0.0

package/es/AeSdk.d.ts

@@ -0,0 +1,37 @@
+import AeSdkBase, { Account } from './AeSdkBase';
+import AccountBase from './account/Base';
+import { EncodedData } from './utils/encoder';
+export default class AeSdk extends AeSdkBase {
+    accounts: {
+        [key: EncodedData<'ak'>]: AccountBase;
+    };
+    selectedAddress?: EncodedData<'ak'>;
+    _resolveAccount(account?: Account | EncodedData<'ak'>): AccountBase;
+    /**
+     * Get accounts addresses
+     * @example addresses()
+     */
+    addresses(): Array<EncodedData<'ak'>>;
+    /**
+     * Add specific account
+     * @param account - Account instance
+     * @param options - Options
+     * @param options.select - Select account
+     * @example addAccount(account)
+     */
+    addAccount(account: AccountBase, { select }?: {
+        select?: boolean;
+    }): Promise<void>;
+    /**
+     * Remove specific account
+     * @param address - Address of account to remove
+     * @example removeAccount(address)
+     */
+    removeAccount(address: EncodedData<'ak'>): void;
+    /**
+     * Select specific account
+     * @param address - Address of account to select
+     * @example selectAccount('ak_xxxxxxxx')
+     */
+    selectAccount(address: EncodedData<'ak'>): void;
+}

package/es/AeSdk.mjs

@@ -0,0 +1,81 @@
+import _defineProperty from "@babel/runtime-corejs3/helpers/defineProperty";
+import AeSdkBase from "./AeSdkBase.mjs";
+import { decode } from "./utils/encoder.mjs";
+import { UnavailableAccountError } from "./utils/errors.mjs";
+export default class AeSdk extends AeSdkBase {
+  constructor() {
+    super(...arguments);
+
+    _defineProperty(this, "accounts", {});
+  }
+
+  _resolveAccount() {
+    let account = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.selectedAddress;
+
+    if (typeof account === 'string') {
+      const address = account;
+      decode(address);
+      if (this.accounts[address] == null) throw new UnavailableAccountError(account);
+      account = this.accounts[address];
+    }
+
+    return super._resolveAccount(account);
+  }
+  /**
+   * Get accounts addresses
+   * @example addresses()
+   */
+
+
+  addresses() {
+    return Object.keys(this.accounts);
+  }
+  /**
+   * Add specific account
+   * @param account - Account instance
+   * @param options - Options
+   * @param options.select - Select account
+   * @example addAccount(account)
+   */
+
+
+  async addAccount(account) {
+    let {
+      select
+    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    const address = await account.address();
+    this.accounts[address] = account;
+    if (select === true) this.selectAccount(address);
+  }
+  /**
+   * Remove specific account
+   * @param address - Address of account to remove
+   * @example removeAccount(address)
+   */
+
+
+  removeAccount(address) {
+    if (this.accounts[address] == null) {
+      console.warn(`removeAccount: Account for ${address} not available`);
+      return;
+    }
+
+    delete this.accounts[address]; // eslint-disable-line @typescript-eslint/no-dynamic-delete
+
+    if (this.selectedAddress === address) delete this.selectedAddress;
+  }
+  /**
+   * Select specific account
+   * @param address - Address of account to select
+   * @example selectAccount('ak_xxxxxxxx')
+   */
+
+
+  selectAccount(address) {
+    decode(address);
+    if (this.accounts[address] == null) throw new UnavailableAccountError(address);
+    this.selectedAddress = address;
+  }
+
+}
+//# sourceMappingURL=AeSdk.mjs.map

package/es/AeSdk.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AeSdk.mjs","names":["AeSdkBase","decode","UnavailableAccountError","AeSdk","_resolveAccount","account","selectedAddress","address","accounts","addresses","Object","keys","addAccount","select","selectAccount","removeAccount","console","warn"],"sources":["../src/AeSdk.ts"],"sourcesContent":["import AeSdkBase, { Account } from './AeSdkBase'\nimport AccountBase from './account/Base'\nimport { decode, EncodedData } from './utils/encoder'\nimport { UnavailableAccountError } from './utils/errors'\n\nexport default class AeSdk extends AeSdkBase {\n  accounts: { [key: EncodedData<'ak'>]: AccountBase } = {}\n  selectedAddress?: EncodedData<'ak'>\n\n  _resolveAccount (account: Account | EncodedData<'ak'> = this.selectedAddress): AccountBase {\n    if (typeof account === 'string') {\n      const address = account as EncodedData<'ak'>\n      decode(address)\n      if (this.accounts[address] == null) throw new UnavailableAccountError(account)\n      account = this.accounts[address]\n    }\n    return super._resolveAccount(account)\n  }\n\n  /**\n   * Get accounts addresses\n   * @example addresses()\n   */\n  addresses (): Array<EncodedData<'ak'>> {\n    return Object.keys(this.accounts) as Array<EncodedData<'ak'>>\n  }\n\n  /**\n   * Add specific account\n   * @param account - Account instance\n   * @param options - Options\n   * @param options.select - Select account\n   * @example addAccount(account)\n   */\n  async addAccount (account: AccountBase, { select }: { select?: boolean } = {}): Promise<void> {\n    const address = await account.address()\n    this.accounts[address] = account\n    if (select === true) this.selectAccount(address)\n  }\n\n  /**\n   * Remove specific account\n   * @param address - Address of account to remove\n   * @example removeAccount(address)\n   */\n  removeAccount (address: EncodedData<'ak'>): void {\n    if (this.accounts[address] == null) {\n      console.warn(`removeAccount: Account for ${address} not available`)\n      return\n    }\n    delete this.accounts[address] // eslint-disable-line @typescript-eslint/no-dynamic-delete\n    if (this.selectedAddress === address) delete this.selectedAddress\n  }\n\n  /**\n   * Select specific account\n   * @param address - Address of account to select\n   * @example selectAccount('ak_xxxxxxxx')\n   */\n  selectAccount (address: EncodedData<'ak'>): void {\n    decode(address)\n    if (this.accounts[address] == null) throw new UnavailableAccountError(address)\n    this.selectedAddress = address\n  }\n}\n"],"mappings":";OAAOA,S;SAEEC,M;SACAC,uB;AAET,eAAe,MAAMC,KAAN,SAAoBH,SAApB,CAA8B;EAAA;IAAA;;IAAA,kCACW,EADX;EAAA;;EAI3CI,eAAe,GAA4E;IAAA,IAA1EC,OAA0E,uEAAnC,KAAKC,eAA8B;;IACzF,IAAI,OAAOD,OAAP,KAAmB,QAAvB,EAAiC;MAC/B,MAAME,OAAO,GAAGF,OAAhB;MACAJ,MAAM,CAACM,OAAD,CAAN;MACA,IAAI,KAAKC,QAAL,CAAcD,OAAd,KAA0B,IAA9B,EAAoC,MAAM,IAAIL,uBAAJ,CAA4BG,OAA5B,CAAN;MACpCA,OAAO,GAAG,KAAKG,QAAL,CAAcD,OAAd,CAAV;IACD;;IACD,OAAO,MAAMH,eAAN,CAAsBC,OAAtB,CAAP;EACD;EAED;AACF;AACA;AACA;;;EACEI,SAAS,GAA8B;IACrC,OAAOC,MAAM,CAACC,IAAP,CAAY,KAAKH,QAAjB,CAAP;EACD;EAED;AACF;AACA;AACA;AACA;AACA;AACA;;;EACkB,MAAVI,UAAU,CAAEP,OAAF,EAA8E;IAAA,IAAtD;MAAEQ;IAAF,CAAsD,uEAAnB,EAAmB;IAC5F,MAAMN,OAAO,GAAG,MAAMF,OAAO,CAACE,OAAR,EAAtB;IACA,KAAKC,QAAL,CAAcD,OAAd,IAAyBF,OAAzB;IACA,IAAIQ,MAAM,KAAK,IAAf,EAAqB,KAAKC,aAAL,CAAmBP,OAAnB;EACtB;EAED;AACF;AACA;AACA;AACA;;;EACEQ,aAAa,CAAER,OAAF,EAAoC;IAC/C,IAAI,KAAKC,QAAL,CAAcD,OAAd,KAA0B,IAA9B,EAAoC;MAClCS,OAAO,CAACC,IAAR,CAAc,8BAA6BV,OAAQ,gBAAnD;MACA;IACD;;IACD,OAAO,KAAKC,QAAL,CAAcD,OAAd,CAAP,CAL+C,CAKjB;;IAC9B,IAAI,KAAKD,eAAL,KAAyBC,OAA7B,EAAsC,OAAO,KAAKD,eAAZ;EACvC;EAED;AACF;AACA;AACA;AACA;;;EACEQ,aAAa,CAAEP,OAAF,EAAoC;IAC/CN,MAAM,CAACM,OAAD,CAAN;IACA,IAAI,KAAKC,QAAL,CAAcD,OAAd,KAA0B,IAA9B,EAAoC,MAAM,IAAIL,uBAAJ,CAA4BK,OAA5B,CAAN;IACpC,KAAKD,eAAL,GAAuBC,OAAvB;EACD;;AA1D0C"}

package/es/AeSdkAepp.d.ts

@@ -0,0 +1,69 @@
+import AeSdkBase, { Account } from './AeSdkBase';
+import AccountBase from './account/Base';
+import { EncodedData } from './utils/encoder';
+import { Accounts, WalletInfo, Network, WalletApi, AeppApi } from './aepp-wallet-communication/rpc/types';
+import RpcClient from './aepp-wallet-communication/rpc/RpcClient';
+import { METHODS, SUBSCRIPTION_TYPES } from './aepp-wallet-communication/schema';
+import BrowserConnection from './aepp-wallet-communication/connection/Browser';
+/**
+ * RPC handler for AEPP side
+ * Contain functionality for wallet interaction and connect it to sdk
+ */
+export default class AeSdkAepp extends AeSdkBase {
+    name: string;
+    onAddressChange: (a: Accounts) => void;
+    onDisconnect: (p: any) => void;
+    onNetworkChange: (a: Network) => void;
+    rpcClient?: RpcClient<WalletApi, AeppApi>;
+    _accounts?: Accounts;
+    /**
+     * @param options - Options
+     * @param options.name - Aepp name
+     * @param options.onAddressChange - Call-back function for update address event
+     * @param options.onDisconnect - Call-back function for disconnect event
+     * @param options.onNetworkChange - Call-back function for update network event
+     */
+    constructor({ name, onAddressChange, onDisconnect, onNetworkChange, ...other }: {
+        name: string;
+        onAddressChange: (a: Accounts) => void;
+        onDisconnect: (p: any) => void;
+        onNetworkChange: (a: Network) => void;
+    } & ConstructorParameters<typeof AeSdkBase>[0]);
+    _resolveAccount(account?: Account): AccountBase;
+    addresses(): Array<EncodedData<'ak'>>;
+    /**
+     * Connect to wallet
+     * @param connection - Wallet connection object
+     * @param options - Options
+     * @param options.connectNode - Request wallet to bind node
+     * @param options.name - Node name
+     * @param options.select - Select this node as current
+     */
+    connectToWallet(connection: BrowserConnection, { connectNode, name, select }?: {
+        connectNode?: boolean;
+        name?: string;
+        select?: boolean;
+    }): Promise<WalletInfo>;
+    /**
+     * Disconnect from wallet
+     */
+    disconnectWallet(): void;
+    /**
+     * Ask addresses from wallet
+     * @returns Addresses from wallet
+     */
+    askAddresses(): Promise<Array<EncodedData<'ak'>>>;
+    /**
+     * Subscribe for addresses from wallet
+     * @param type - Subscription type
+     * @param value - Should be one of 'current' (the selected account), 'connected' (all)
+     * @returns Accounts from wallet
+     */
+    subscribeAddress(type: SUBSCRIPTION_TYPES, value: 'current' | 'connected'): Promise<ReturnType<WalletApi[METHODS.subscribeAddress]>>;
+    _ensureConnected(): asserts this is AeSdkAepp & {
+        rpcClient: NonNullable<AeSdkAepp['rpcClient']>;
+    };
+    _ensureAccountAccess(): asserts this is AeSdkAepp & {
+        rpcClient: NonNullable<AeSdkAepp['rpcClient']>;
+    };
+}

package/es/AeSdkAepp.mjs

@@ -0,0 +1,175 @@
+import _includesInstanceProperty from "@babel/runtime-corejs3/core-js-stable/instance/includes";
+import AeSdkBase from "./AeSdkBase.mjs";
+import AccountRpc from "./account/Rpc.mjs";
+import { decode } from "./utils/encoder.mjs";
+import { RPC_VERSION } from "./aepp-wallet-communication/rpc/types.mjs";
+import RpcClient from "./aepp-wallet-communication/rpc/RpcClient.mjs";
+import { METHODS } from "./aepp-wallet-communication/schema.mjs";
+import { AlreadyConnectedError, NoWalletConnectedError, UnsubscribedAccountError, UnAuthorizedAccountError, RpcConnectionError } from "./utils/errors.mjs";
+import Node from "./Node.mjs";
+
+/**
+ * RPC handler for AEPP side
+ * Contain functionality for wallet interaction and connect it to sdk
+ */
+export default class AeSdkAepp extends AeSdkBase {
+  /**
+   * @param options - Options
+   * @param options.name - Aepp name
+   * @param options.onAddressChange - Call-back function for update address event
+   * @param options.onDisconnect - Call-back function for disconnect event
+   * @param options.onNetworkChange - Call-back function for update network event
+   */
+  constructor(_ref) {
+    let {
+      name,
+      onAddressChange = () => {},
+      onDisconnect = () => {},
+      onNetworkChange = () => {},
+      ...other
+    } = _ref;
+    super(other);
+    this.onAddressChange = onAddressChange;
+    this.onDisconnect = onDisconnect;
+    this.onNetworkChange = onNetworkChange;
+    this.name = name;
+  }
+
+  _resolveAccount() {
+    let account = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : this.addresses()[0];
+
+    if (typeof account === 'string') {
+      var _context;
+
+      const address = account;
+      decode(address);
+      if (!_includesInstanceProperty(_context = this.addresses()).call(_context, address)) throw new UnAuthorizedAccountError(address);
+      account = new AccountRpc({
+        rpcClient: this.rpcClient,
+        address
+      });
+    }
+
+    if (account == null) this._ensureAccountAccess();
+    return super._resolveAccount(account);
+  }
+
+  addresses() {
+    if (this._accounts == null) return [];
+    const current = Object.keys(this._accounts.current)[0];
+    return [...(current != null ? [current] : []), ...Object.keys(this._accounts.connected)];
+  }
+  /**
+   * Connect to wallet
+   * @param connection - Wallet connection object
+   * @param options - Options
+   * @param options.connectNode - Request wallet to bind node
+   * @param options.name - Node name
+   * @param options.select - Select this node as current
+   */
+
+
+  async connectToWallet(connection) {
+    let {
+      connectNode = false,
+      name = 'wallet-node',
+      select = false
+    } = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+    if (this.rpcClient != null) throw new AlreadyConnectedError('You are already connected to wallet');
+    let disconnectParams;
+    const client = new RpcClient(connection, () => {
+      delete this.rpcClient;
+      delete this._accounts;
+      this.onDisconnect(disconnectParams);
+    }, {
+      [METHODS.updateAddress]: params => {
+        this._accounts = params;
+        this.onAddressChange(params);
+      },
+      [METHODS.updateNetwork]: params => {
+        const {
+          node
+        } = params;
+        if (node != null) this.addNode(node.name, new Node(node.url), true);
+        this.onNetworkChange(params);
+      },
+      [METHODS.closeConnection]: params => {
+        disconnectParams = params;
+        client.connection.disconnect();
+      },
+      [METHODS.readyToConnect]: () => {}
+    });
+    const {
+      node,
+      ...walletInfo
+    } = await client.request(METHODS.connect, {
+      name: this.name,
+      version: RPC_VERSION,
+      connectNode
+    });
+
+    if (connectNode) {
+      if (node == null) throw new RpcConnectionError('Missing URLs of the Node');
+      this.addNode(name, new Node(node.url), select);
+    }
+
+    this.rpcClient = client;
+    return walletInfo;
+  }
+  /**
+   * Disconnect from wallet
+   */
+
+
+  disconnectWallet() {
+    this._ensureConnected();
+
+    this.rpcClient.notify(METHODS.closeConnection, {
+      reason: 'bye'
+    });
+    this.rpcClient.connection.disconnect();
+  }
+  /**
+   * Ask addresses from wallet
+   * @returns Addresses from wallet
+   */
+
+
+  async askAddresses() {
+    this._ensureAccountAccess();
+
+    return await this.rpcClient.request(METHODS.address, undefined);
+  }
+  /**
+   * Subscribe for addresses from wallet
+   * @param type - Subscription type
+   * @param value - Should be one of 'current' (the selected account), 'connected' (all)
+   * @returns Accounts from wallet
+   */
+
+
+  async subscribeAddress(type, value) {
+    this._ensureConnected();
+
+    const result = await this.rpcClient.request(METHODS.subscribeAddress, {
+      type,
+      value
+    });
+    this._accounts = result.address;
+    return result;
+  }
+
+  _ensureConnected() {
+    if (this.rpcClient != null) return;
+    throw new NoWalletConnectedError('You are not connected to Wallet');
+  }
+
+  _ensureAccountAccess() {
+    this._ensureConnected();
+
+    if (this.addresses().length !== 0) return;
+    throw new UnsubscribedAccountError();
+  }
+
+}
+//# sourceMappingURL=AeSdkAepp.mjs.map

package/es/AeSdkAepp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AeSdkAepp.mjs","names":["AeSdkBase","AccountRpc","decode","RPC_VERSION","RpcClient","METHODS","AlreadyConnectedError","NoWalletConnectedError","UnsubscribedAccountError","UnAuthorizedAccountError","RpcConnectionError","Node","AeSdkAepp","constructor","name","onAddressChange","onDisconnect","onNetworkChange","other","_resolveAccount","account","addresses","address","rpcClient","_ensureAccountAccess","_accounts","current","Object","keys","connected","connectToWallet","connection","connectNode","select","disconnectParams","client","updateAddress","params","updateNetwork","node","addNode","url","closeConnection","disconnect","readyToConnect","walletInfo","request","connect","version","disconnectWallet","_ensureConnected","notify","reason","askAddresses","undefined","subscribeAddress","type","value","result","length"],"sources":["../src/AeSdkAepp.ts"],"sourcesContent":["import AeSdkBase, { Account } from './AeSdkBase'\nimport AccountBase from './account/Base'\nimport AccountRpc from './account/Rpc'\nimport { decode, EncodedData } from './utils/encoder'\nimport { Accounts, RPC_VERSION, WalletInfo, Network, WalletApi, AeppApi } from './aepp-wallet-communication/rpc/types'\nimport RpcClient from './aepp-wallet-communication/rpc/RpcClient'\nimport { METHODS, SUBSCRIPTION_TYPES } from './aepp-wallet-communication/schema'\nimport {\n  AlreadyConnectedError,\n  NoWalletConnectedError,\n  UnsubscribedAccountError,\n  UnAuthorizedAccountError,\n  RpcConnectionError\n} from './utils/errors'\nimport Node from './Node'\nimport BrowserConnection from './aepp-wallet-communication/connection/Browser'\n\n/**\n * RPC handler for AEPP side\n * Contain functionality for wallet interaction and connect it to sdk\n */\nexport default class AeSdkAepp extends AeSdkBase {\n  name: string\n  onAddressChange: (a: Accounts) => void\n  onDisconnect: (p: any) => void\n  onNetworkChange: (a: Network) => void\n  rpcClient?: RpcClient<WalletApi, AeppApi>\n  _accounts?: Accounts\n\n  /**\n   * @param options - Options\n   * @param options.name - Aepp name\n   * @param options.onAddressChange - Call-back function for update address event\n   * @param options.onDisconnect - Call-back function for disconnect event\n   * @param options.onNetworkChange - Call-back function for update network event\n   */\n  constructor ({\n    name,\n    onAddressChange = () => {},\n    onDisconnect = () => {},\n    onNetworkChange = () => {},\n    ...other\n  }: {\n    name: string\n    onAddressChange: (a: Accounts) => void\n    onDisconnect: (p: any) => void\n    onNetworkChange: (a: Network) => void\n  } & ConstructorParameters<typeof AeSdkBase>[0]) {\n    super(other)\n    this.onAddressChange = onAddressChange\n    this.onDisconnect = onDisconnect\n    this.onNetworkChange = onNetworkChange\n    this.name = name\n  }\n\n  _resolveAccount (account: Account = this.addresses()[0]): AccountBase {\n    if (typeof account === 'string') {\n      const address = account as EncodedData<'ak'>\n      decode(address)\n      if (!this.addresses().includes(address)) throw new UnAuthorizedAccountError(address)\n      account = new AccountRpc({ rpcClient: this.rpcClient, address })\n    }\n    if (account == null) this._ensureAccountAccess()\n    return super._resolveAccount(account)\n  }\n\n  addresses (): Array<EncodedData<'ak'>> {\n    if (this._accounts == null) return []\n    const current = Object.keys(this._accounts.current)[0]\n    return [\n      ...current != null ? [current] : [], ...Object.keys(this._accounts.connected)\n    ] as Array<EncodedData<'ak'>>\n  }\n\n  /**\n   * Connect to wallet\n   * @param connection - Wallet connection object\n   * @param options - Options\n   * @param options.connectNode - Request wallet to bind node\n   * @param options.name - Node name\n   * @param options.select - Select this node as current\n   */\n  async connectToWallet (\n    connection: BrowserConnection,\n    { connectNode = false, name = 'wallet-node', select = false }:\n    { connectNode?: boolean, name?: string, select?: boolean } = {}\n  ): Promise<WalletInfo> {\n    if (this.rpcClient != null) throw new AlreadyConnectedError('You are already connected to wallet')\n    let disconnectParams: any\n    const client = new RpcClient<WalletApi, AeppApi>(\n      connection,\n      () => {\n        delete this.rpcClient\n        delete this._accounts\n        this.onDisconnect(disconnectParams)\n      }, {\n        [METHODS.updateAddress]: (params) => {\n          this._accounts = params\n          this.onAddressChange(params)\n        },\n        [METHODS.updateNetwork]: (params) => {\n          const { node } = params\n          if (node != null) this.addNode(node.name, new Node(node.url), true)\n          this.onNetworkChange(params)\n        },\n        [METHODS.closeConnection]: (params) => {\n          disconnectParams = params\n          client.connection.disconnect()\n        },\n        [METHODS.readyToConnect]: () => {}\n      }\n    )\n    const { node, ...walletInfo } = await client.request(\n      METHODS.connect, { name: this.name, version: RPC_VERSION, connectNode }\n    )\n    if (connectNode) {\n      if (node == null) throw new RpcConnectionError('Missing URLs of the Node')\n      this.addNode(name, new Node(node.url), select)\n    }\n    this.rpcClient = client\n    return walletInfo\n  }\n\n  /**\n   * Disconnect from wallet\n   */\n  disconnectWallet (): void {\n    this._ensureConnected()\n    this.rpcClient.notify(METHODS.closeConnection, { reason: 'bye' })\n    this.rpcClient.connection.disconnect()\n  }\n\n  /**\n   * Ask addresses from wallet\n   * @returns Addresses from wallet\n   */\n  async askAddresses (): Promise<Array<EncodedData<'ak'>>> {\n    this._ensureAccountAccess()\n    return await this.rpcClient.request(METHODS.address, undefined)\n  }\n\n  /**\n   * Subscribe for addresses from wallet\n   * @param type - Subscription type\n   * @param value - Should be one of 'current' (the selected account), 'connected' (all)\n   * @returns Accounts from wallet\n   */\n  async subscribeAddress (\n    type: SUBSCRIPTION_TYPES, value: 'current' | 'connected'\n  ): Promise<ReturnType<WalletApi[METHODS.subscribeAddress]>> {\n    this._ensureConnected()\n    const result = await this.rpcClient.request(METHODS.subscribeAddress, { type, value })\n    this._accounts = result.address\n    return result\n  }\n\n  _ensureConnected (): asserts this is AeSdkAepp & { rpcClient: NonNullable<AeSdkAepp['rpcClient']> } {\n    if (this.rpcClient != null) return\n    throw new NoWalletConnectedError('You are not connected to Wallet')\n  }\n\n  _ensureAccountAccess (): asserts this is AeSdkAepp & { rpcClient: NonNullable<AeSdkAepp['rpcClient']> } {\n    this._ensureConnected()\n    if (this.addresses().length !== 0) return\n    throw new UnsubscribedAccountError()\n  }\n}\n"],"mappings":"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"}

package/es/AeSdkBase.d.ts

@@ -0,0 +1,212 @@
+import * as chainMethods from './chain';
+import * as txMethods from './tx';
+import * as aensMethods from './aens';
+import * as spendMethods from './spend';
+import * as oracleMethods from './oracle';
+import * as contractMethods from './contract/methods';
+import * as contractGaMethods from './contract/ga';
+import { _buildTx } from './tx';
+import Node, { getNetworkId } from './Node';
+import { AE_AMOUNT_FORMATS } from './utils/amount-formatter';
+import { TX_TYPE } from './tx/builder/schema';
+import { Keypair } from './account/Memory';
+import AccountBase from './account/Base';
+import { EncodedData } from './utils/encoder';
+import Compiler from './contract/Compiler';
+export declare type Account = Keypair | AccountBase | any;
+declare type NodeInfo = Awaited<ReturnType<Node['getNodeInfo']>> & {
+    name: string;
+};
+/**
+ * Basic AeSdk class
+ *
+ * AeSdkBase objects are the composition of:
+ * - chain methods
+ * - tx methods
+ * - aens methods
+ * - spend methods
+ * - oracle methods
+ * - contract methods
+ * - contract ga methods
+ * Only by providing the joint functionality of them, most more advanced
+ * operations, i.e. the ones with actual use value on the chain, become
+ * available.
+ */
+declare class AeSdkBase {
+    _options: {
+        denomination: AE_AMOUNT_FORMATS;
+        amount: number;
+        [key: string]: any;
+    };
+    pool: Map<string, Node>;
+    selectedNodeName?: string;
+    compilerApi: Compiler;
+    /**
+     * @param options - Options
+     * @param options.nodes - Array of nodes
+     * @param options.compilerUrl - Url for compiler API
+     * @param options.ignoreVersion - Don't check node or compiler version
+     */
+    constructor({ nodes, compilerUrl, ignoreVersion, ...options }?: {
+        nodes?: Array<{
+            name: string;
+            instance: Node;
+        }>;
+        compilerUrl?: string;
+        ignoreVersion?: boolean;
+        [key: string]: any;
+    });
+    setCompilerUrl(compilerUrl: string, { ignoreVersion }?: {
+        ignoreVersion?: boolean;
+    }): void;
+    get api(): Node;
+    /**
+     * Add Node
+     * @param name - Node name
+     * @param node - Node instance
+     * @param select - Select this node as current
+     * @example
+     * ```js
+     * // add and select new node with name 'testNode'
+     * aeSdkBase.addNode('testNode', new Node({ url }), true)
+     * ```
+     */
+    addNode(name: string, node: Node, select?: boolean): void;
+    /**
+     * Select Node
+     * @param name - Node name
+     * @example
+     * nodePool.selectNode('testNode')
+     */
+    selectNode(name: string): void;
+    /**
+     * Get NetworkId of current Node
+     * @example
+     * nodePool.getNetworkId()
+     */
+    readonly getNetworkId: typeof getNetworkId;
+    /**
+     * Check if you have selected node
+     * @example
+     * nodePool.isNodeConnected()
+     */
+    isNodeConnected(): this is AeSdkBase & {
+        selectedNodeName: string;
+    };
+    protected ensureNodeConnected(): asserts this is AeSdkBase & {
+        selectedNodeName: string;
+    };
+    /**
+     * Get information about node
+     * @example
+     * ```js
+     * nodePool.getNodeInfo() // { name, version, networkId, protocol, ... }
+     * ```
+     */
+    getNodeInfo(): Promise<NodeInfo>;
+    /**
+     * Get array of available nodes
+     * @example
+     * nodePool.getNodesInPool()
+     */
+    getNodesInPool(): Promise<NodeInfo[]>;
+    addresses(): Array<EncodedData<'ak'>>;
+    address({ onAccount }?: {
+        onAccount?: Account;
+    }): Promise<EncodedData<'ak'>>;
+    sign(data: string | Uint8Array, { onAccount, ...options }?: {
+        onAccount?: Account;
+    }): Promise<Uint8Array>;
+    signTransaction(tx: EncodedData<'tx'>, { onAccount, ...options }?: {
+        onAccount?: Account;
+    } & Parameters<AccountBase['signTransaction']>[1]): Promise<EncodedData<'tx'>>;
+    signMessage(message: string, { onAccount, ...options }?: {
+        onAccount?: Account;
+    } & Parameters<AccountBase['signMessage']>[1]): Promise<string | Uint8Array>;
+    verifyMessage(message: string, signature: string | Uint8Array, { onAccount, ...options }?: {
+        onAccount?: Account;
+    } & Parameters<AccountBase['verifyMessage']>[2]): Promise<boolean>;
+    /**
+     * Resolves an account
+     * @param account - ak-address, instance of AccountBase, or keypair
+     */
+    _resolveAccount(account?: Account): AccountBase;
+    _getOptions(): Promise<{
+        onNode: Node;
+        onAccount: AccountBase;
+        onCompiler: Compiler;
+        networkId: string;
+    }>;
+    buildTx<TxType extends TX_TYPE>(txType: TxType, options: Omit<Parameters<typeof _buildTx<TxType>>[1], 'onNode'> & {
+        onNode?: Node;
+    }): Promise<EncodedData<'tx'>>;
+}
+declare const methods: {
+    readonly isGA: typeof contractGaMethods.isGA;
+    readonly createGeneralizedAccount: typeof contractGaMethods.createGeneralizedAccount;
+    readonly createMetaTx: typeof contractGaMethods.createMetaTx;
+    readonly buildAuthTxHash: typeof contractGaMethods.buildAuthTxHash;
+    readonly createAensDelegationSignature: typeof contractMethods.createAensDelegationSignature;
+    readonly createOracleDelegationSignature: typeof contractMethods.createOracleDelegationSignature;
+    readonly getContractInstance: typeof contractMethods.getContractInstance;
+    readonly getOracleObject: typeof oracleMethods.getOracleObject;
+    readonly pollForQueries: typeof oracleMethods.pollForQueries;
+    readonly getQueryObject: typeof oracleMethods.getQueryObject;
+    readonly pollForQueryResponse: typeof oracleMethods.pollForQueryResponse;
+    readonly registerOracle: typeof oracleMethods.registerOracle;
+    readonly postQueryToOracle: typeof oracleMethods.postQueryToOracle;
+    readonly extendOracleTtl: typeof oracleMethods.extendOracleTtl;
+    readonly respondToQuery: typeof oracleMethods.respondToQuery;
+    readonly send: typeof spendMethods.send;
+    readonly signUsingGA: typeof spendMethods.signUsingGA;
+    readonly spend: typeof spendMethods.spend;
+    readonly transferFunds: typeof spendMethods.transferFunds;
+    readonly payForTransaction: typeof spendMethods.payForTransaction;
+    readonly aensRevoke: typeof aensMethods.aensRevoke;
+    readonly aensUpdate: typeof aensMethods.aensUpdate;
+    readonly aensTransfer: typeof aensMethods.aensTransfer;
+    readonly aensQuery: typeof aensMethods.aensQuery;
+    readonly aensClaim: typeof aensMethods.aensClaim;
+    readonly aensPreclaim: typeof aensMethods.aensPreclaim;
+    readonly aensBid: typeof aensMethods.aensBid;
+    readonly getVmVersion: typeof txMethods.getVmVersion;
+    readonly prepareTxParams: typeof txMethods.prepareTxParams;
+    readonly _getPollInterval: typeof chainMethods._getPollInterval;
+    readonly sendTransaction: typeof chainMethods.sendTransaction;
+    readonly waitForTxConfirm: typeof chainMethods.waitForTxConfirm;
+    readonly getAccount: typeof chainMethods.getAccount;
+    readonly getBalance: typeof chainMethods.getBalance;
+    readonly height: typeof chainMethods.height;
+    readonly awaitHeight: typeof chainMethods.awaitHeight;
+    readonly poll: typeof chainMethods.poll;
+    readonly getCurrentGeneration: typeof chainMethods.getCurrentGeneration;
+    readonly getGeneration: typeof chainMethods.getGeneration;
+    readonly getMicroBlockTransactions: typeof chainMethods.getMicroBlockTransactions;
+    readonly getKeyBlock: typeof chainMethods.getKeyBlock;
+    readonly getMicroBlockHeader: typeof chainMethods.getMicroBlockHeader;
+    readonly txDryRun: typeof chainMethods.txDryRun;
+    readonly getContractByteCode: typeof chainMethods.getContractByteCode;
+    readonly getContract: typeof chainMethods.getContract;
+    readonly getName: typeof chainMethods.getName;
+    readonly resolveName: typeof chainMethods.resolveName;
+};
+declare type RequiredKeys<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? never : K;
+}[keyof T];
+declare type OptionalIfNotRequired<T extends [any]> = RequiredKeys<T[0]> extends never ? T | [] : T;
+declare type MakeOptional<Args extends any[]> = Args extends [infer Head, ...infer Tail] ? Tail extends [] ? Head extends object ? OptionalIfNotRequired<[
+    Omit<Head, 'onNode' | 'onCompiler' | 'onAccount'> & {
+        onNode?: Node;
+        onCompiler?: Compiler;
+        onAccount?: AccountBase | EncodedData<'ak'> | Keypair;
+    }
+]> : [Head] : [Head, ...MakeOptional<Tail>] : never;
+declare type TransformMethods<Methods extends {
+    [key: string]: Function;
+}> = {
+    [Name in keyof Methods]: Methods[Name] extends (...args: infer Args) => infer Ret ? (...args: MakeOptional<Args>) => Ret : never;
+};
+interface AeSdkBaseMethods extends TransformMethods<typeof methods> {
+}
+declare const _default: new (options: ConstructorParameters<typeof AeSdkBase>[0]) => AeSdkBase & AeSdkBaseMethods;
+export default _default;