@aeternity/aepp-sdk 11.0.0 → 12.1.0

package/es/AeSdk.d.ts

@@ -0,0 +1,37 @@
+import AeSdkBase, { Account } from './AeSdkBase';
+import AccountBase from './account/Base';
+import { Encoded } from './utils/encoder';
+export default class AeSdk extends AeSdkBase {
+    accounts: {
+        [key: Encoded.AccountAddress]: AccountBase;
+    };
+    selectedAddress?: Encoded.AccountAddress;
+    _resolveAccount(account?: Account | Encoded.AccountAddress): AccountBase;
+    /**
+     * Get accounts addresses
+     * @example addresses()
+     */
+    addresses(): Encoded.AccountAddress[];
+    /**
+     * 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: Encoded.AccountAddress): void;
+    /**
+     * Select specific account
+     * @param address - Address of account to select
+     * @example selectAccount('ak_xxxxxxxx')
+     */
+    selectAccount(address: Encoded.AccountAddress): 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, Encoded } from './utils/encoder';\nimport { UnavailableAccountError } from './utils/errors';\n\nexport default class AeSdk extends AeSdkBase {\n  accounts: { [key: Encoded.AccountAddress]: AccountBase } = {};\n\n  selectedAddress?: Encoded.AccountAddress;\n\n  _resolveAccount(\n    account: Account | Encoded.AccountAddress = this.selectedAddress,\n  ): AccountBase {\n    if (typeof account === 'string') {\n      const address = account as Encoded.AccountAddress;\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(): Encoded.AccountAddress[] {\n    return Object.keys(this.accounts) as Encoded.AccountAddress[];\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: Encoded.AccountAddress): 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: Encoded.AccountAddress): 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,kCACgB,EADhB;EAAA;;EAK3CI,eAAe,GAEA;IAAA,IADbC,OACa,uEAD+B,KAAKC,eACpC;;IACb,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,GAA6B;IACpC,OAAOC,MAAM,CAACC,IAAP,CAAY,KAAKH,QAAjB,CAAP;EACD;EAED;AACF;AACA;AACA;AACA;AACA;AACA;;;EACkB,MAAVI,UAAU,CAACP,OAAD,EAA6E;IAAA,IAAtD;MAAEQ;IAAF,CAAsD,uEAAnB,EAAmB;IAC3F,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,CAACR,OAAD,EAAwC;IACnD,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,CALmD,CAKpB;;IAC/B,IAAI,KAAKD,eAAL,KAAyBC,OAA7B,EAAsC,OAAO,KAAKD,eAAZ;EACvC;EAED;AACF;AACA;AACA;AACA;;;EACEQ,aAAa,CAACP,OAAD,EAAwC;IACnDN,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;;AA7D0C"}

package/es/AeSdkAepp.d.ts

@@ -0,0 +1,70 @@
+import AeSdkBase, { Account } from './AeSdkBase';
+import AccountBase from './account/Base';
+import { Encoded } 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
+ * @category aepp wallet communication
+ */
+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(): Encoded.AccountAddress[];
+    /**
+     * 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<Encoded.AccountAddress[]>;
+    /**
+     * 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,176 @@
+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
+ * @category aepp wallet communication
+ */
+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 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, Encoded } from './utils/encoder';\nimport {\n  Accounts, RPC_VERSION, WalletInfo, Network, WalletApi, AeppApi,\n} 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 * @category aepp wallet communication\n */\nexport default class AeSdkAepp extends AeSdkBase {\n  name: string;\n\n  onAddressChange: (a: Accounts) => void;\n\n  onDisconnect: (p: any) => void;\n\n  onNetworkChange: (a: Network) => void;\n\n  rpcClient?: RpcClient<WalletApi, AeppApi>;\n\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 Encoded.AccountAddress;\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(): Encoded.AccountAddress[] {\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 Encoded.AccountAddress[];\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      {\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\n      .request(METHODS.connect, { name: this.name, version: RPC_VERSION, connectNode });\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<Encoded.AccountAddress[]> {\n    this._ensureAccountAccess();\n    return 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,\n    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,213 @@
+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 * as deprecatedMethods from './deprecated/methods';
+import { _buildTx } from './tx';
+import Node, { getNetworkId } from './Node';
+import { AE_AMOUNT_FORMATS } from './utils/amount-formatter';
+import { Tag } from './tx/builder/constants';
+import { Keypair } from './account/Memory';
+import AccountBase from './account/Base';
+import { Encoded } 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(): Encoded.AccountAddress[];
+    address({ onAccount }?: {
+        onAccount?: Account;
+    }): Promise<Encoded.AccountAddress>;
+    sign(data: string | Uint8Array, { onAccount, ...options }?: {
+        onAccount?: Account;
+    }): Promise<Uint8Array>;
+    signTransaction(tx: Encoded.Transaction, { onAccount, ...options }?: {
+        onAccount?: Account;
+    } & Parameters<AccountBase['signTransaction']>[1]): Promise<Encoded.Transaction>;
+    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(): {
+        onNode: Node;
+        onAccount: AccountBase;
+        onCompiler: Compiler;
+    };
+    buildTx<TxType extends Tag>(txType: TxType, options: Omit<Parameters<typeof _buildTx<TxType>>[1], 'onNode'> & {
+        onNode?: Node;
+    }): Promise<Encoded.Transaction>;
+}
+declare const methods: {
+    readonly signUsingGA: typeof deprecatedMethods.signUsingGA;
+    readonly height: typeof deprecatedMethods.height;
+    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 pollForQueries: typeof oracleMethods.pollForQueries;
+    readonly pollForQueryResponse: typeof oracleMethods.pollForQueryResponse;
+    readonly getQueryObject: typeof oracleMethods.getQueryObject;
+    readonly postQueryToOracle: typeof oracleMethods.postQueryToOracle;
+    readonly extendOracleTtl: typeof oracleMethods.extendOracleTtl;
+    readonly respondToQuery: typeof oracleMethods.respondToQuery;
+    readonly getOracleObject: typeof oracleMethods.getOracleObject;
+    readonly registerOracle: typeof oracleMethods.registerOracle;
+    readonly send: typeof spendMethods.send;
+    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 getHeight: typeof chainMethods.getHeight;
+    readonly poll: typeof chainMethods.poll;
+    readonly awaitHeight: typeof chainMethods.awaitHeight;
+    readonly waitForTxConfirm: typeof chainMethods.waitForTxConfirm;
+    readonly sendTransaction: typeof chainMethods.sendTransaction;
+    readonly getAccount: typeof chainMethods.getAccount;
+    readonly getBalance: typeof chainMethods.getBalance;
+    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 | Encoded.AccountAddress | 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;