@subwallet/subsquare-api-sdk 1.3.70-2

package/README.md

@@ -0,0 +1 @@
+# subsquare-api-sdk

package/bundle.d.ts

@@ -0,0 +1,4 @@
+import { SubsquareApiSdk } from './subsquare-sdk';
+export { packageInfo } from './packageInfo';
+export declare const getSubsquareApi: (chain: string) => SubsquareApiSdk;
+export { SubsquareApiSdk } from './subsquare-sdk';

package/bundle.js

@@ -0,0 +1,7 @@
+// Copyright 2019-2022 @polkadot/extension-base authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import { SubsquareApiSdk } from "./subsquare-sdk.js";
+export { packageInfo } from "./packageInfo.js";
+export const getSubsquareApi = chain => SubsquareApiSdk.getInstance(chain);
+export { SubsquareApiSdk } from "./subsquare-sdk.js";

package/cjs/bundle.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "SubsquareApiSdk", {
+  enumerable: true,
+  get: function () {
+    return _subsquareSdk.SubsquareApiSdk;
+  }
+});
+exports.getSubsquareApi = void 0;
+Object.defineProperty(exports, "packageInfo", {
+  enumerable: true,
+  get: function () {
+    return _packageInfo.packageInfo;
+  }
+});
+var _subsquareSdk = require("./subsquare-sdk");
+var _packageInfo = require("./packageInfo");
+// Copyright 2019-2022 @polkadot/extension-base authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+const getSubsquareApi = chain => _subsquareSdk.SubsquareApiSdk.getInstance(chain);
+exports.getSubsquareApi = getSubsquareApi;

package/cjs/detectOther.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+// Empty template, auto-generated by @polkadot/dev
+var _default = [];
+exports.default = _default;

package/cjs/detectPackage.js

@@ -0,0 +1,12 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _util = require("@polkadot/util");
+var _detectOther = _interopRequireDefault(require("./detectOther"));
+var _packageInfo = require("./packageInfo");
+// Copyright 2017-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// Do not edit, auto-generated by @polkadot/dev
+
+(0, _util.detectPackage)(_packageInfo.packageInfo, null, _detectOther.default);

package/cjs/index.js

@@ -0,0 +1,45 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  ALL_TRACK_ID: true
+};
+Object.defineProperty(exports, "ALL_TRACK_ID", {
+  enumerable: true,
+  get: function () {
+    return _utils.ALL_TRACK_ID;
+  }
+});
+exports.default = void 0;
+require("./detectPackage");
+var _bundle = require("./bundle");
+Object.keys(_bundle).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _bundle[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _bundle[key];
+    }
+  });
+});
+var _interface = require("./interface");
+Object.keys(_interface).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _interface[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _interface[key];
+    }
+  });
+});
+var _utils = require("./utils");
+// Copyright 2017-2022 @subwallet/subwallet-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+var _default = _bundle.getSubsquareApi;
+exports.default = _default;

package/cjs/interface.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.GovStatusKey = exports.GOV_PREPARING_STATES = exports.GOV_ONGOING_STATES = exports.GOV_COMPLETED_SUCCESS_STATES = exports.GOV_COMPLETED_STATES = exports.GOV_COMPLETED_FAILED_STATES = void 0;
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+/* ReferendumVote */
+/* ReferendumVote */
+/* Gov Status */
+let GovStatusKey;
+exports.GovStatusKey = GovStatusKey;
+(function (GovStatusKey) {
+  GovStatusKey["ALL"] = "All";
+  GovStatusKey["PREPARING"] = "Preparing";
+  GovStatusKey["DECIDING"] = "Deciding";
+  GovStatusKey["CONFIRMING"] = "Confirming";
+  GovStatusKey["QUEUEING"] = "Queueing";
+  GovStatusKey["APPROVED"] = "Approved";
+  GovStatusKey["EXECUTED"] = "Executed";
+  GovStatusKey["REJECTED"] = "Rejected";
+  GovStatusKey["TIMEDOUT"] = "TimedOut";
+  GovStatusKey["CANCELLED"] = "Cancelled";
+  GovStatusKey["KILLED"] = "Killed";
+  GovStatusKey["STARTED"] = "Started";
+  GovStatusKey["PASSED"] = "Passed";
+  GovStatusKey["NOTPASSED"] = "NotPassed";
+})(GovStatusKey || (exports.GovStatusKey = GovStatusKey = {}));
+const GOV_PREPARING_STATES = [GovStatusKey.PREPARING, GovStatusKey.QUEUEING];
+exports.GOV_PREPARING_STATES = GOV_PREPARING_STATES;
+const GOV_ONGOING_STATES = [GovStatusKey.PREPARING, GovStatusKey.DECIDING, GovStatusKey.CONFIRMING, GovStatusKey.QUEUEING, GovStatusKey.STARTED];
+exports.GOV_ONGOING_STATES = GOV_ONGOING_STATES;
+const GOV_COMPLETED_STATES = [GovStatusKey.APPROVED, GovStatusKey.EXECUTED, GovStatusKey.REJECTED, GovStatusKey.TIMEDOUT, GovStatusKey.CANCELLED, GovStatusKey.KILLED, GovStatusKey.PASSED, GovStatusKey.NOTPASSED];
+exports.GOV_COMPLETED_STATES = GOV_COMPLETED_STATES;
+const GOV_COMPLETED_SUCCESS_STATES = [GovStatusKey.APPROVED, GovStatusKey.EXECUTED, GovStatusKey.PASSED];
+exports.GOV_COMPLETED_SUCCESS_STATES = GOV_COMPLETED_SUCCESS_STATES;
+const GOV_COMPLETED_FAILED_STATES = [GovStatusKey.REJECTED, GovStatusKey.TIMEDOUT, GovStatusKey.CANCELLED, GovStatusKey.KILLED, GovStatusKey.NOTPASSED];
+
+/* Gov Status */
+exports.GOV_COMPLETED_FAILED_STATES = GOV_COMPLETED_FAILED_STATES;

package/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/cjs/packageInfo.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.packageInfo = void 0;
+// Copyright 2017-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// Do not edit, auto-generated by @polkadot/dev
+
+const packageInfo = {
+  name: '@subwallet/subsquare-api-sdk',
+  path: typeof __dirname === 'string' ? __dirname : 'auto',
+  type: 'cjs',
+  version: '1.3.70-2'
+};
+exports.packageInfo = packageInfo;

package/cjs/subsquare-sdk.js

@@ -0,0 +1,192 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.SubsquareApiSdk = void 0;
+var _axios = _interopRequireDefault(require("axios"));
+var _url = require("./url");
+var _utils = require("./utils");
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+const specialBaseUrls = {
+  vara: 'https://vara.subsquare.io/api',
+  acala: 'https://acala.subsquare.io/api',
+  centrifuge: 'https://centrifuge.subsquare.io/api',
+  laos: 'https://laos.subsquare.io/api/',
+  interlay: 'https://interlay.subsquare.io/api',
+  karura: 'https://karura.subsquare.io/api',
+  kintsugi: 'https://kintsugi.subsquare.io/api'
+};
+const LegacyGovChains = ['ajuna', 'astar', 'phala', 'heima', 'acala', 'centrifuge', 'interlay', 'laos', 'karura', 'kintsugi'];
+class SubsquareApiSdk {
+  static instances = new Map();
+  isLegacyGov = false;
+  constructor(chain) {
+    const baseURL = specialBaseUrls[chain] || `https://${chain}-api.subsquare.io`;
+    this.isLegacyGov = LegacyGovChains.includes(chain);
+    this.client = _axios.default.create({
+      baseURL
+    });
+    this.chain = chain;
+  }
+  static getInstance(chain) {
+    if (!this.instances.has(chain)) {
+      this.instances.set(chain, new SubsquareApiSdk(chain));
+    }
+    return this.instances.get(chain);
+  }
+  async getMigrationBlockOffset(blockTime) {
+    try {
+      const urls = [`/stream/relay-chain-height?interval=${blockTime * 1000}`, `/stream/scan-height?interval=${blockTime * 1000}`];
+      const results = await Promise.allSettled(urls.map(async url => {
+        const res = await fetch(new URL(url, this.client.defaults.baseURL));
+        if (!res.body) {
+          throw new Error('Response body is null');
+        }
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const readResult = await reader.read();
+        const {
+          done,
+          value
+        } = readResult;
+        if (done || !value) {
+          throw new Error('No data from stream');
+        }
+        const text = decoder.decode(value);
+        const data = JSON.parse(text);
+        return data.value;
+      }));
+      const [relayResult, scanResult] = results;
+      const relayHeight = relayResult.status === 'fulfilled' ? relayResult.value : null;
+      const scanHeight = scanResult.status === 'fulfilled' ? scanResult.value : null;
+      let offset;
+      if (relayHeight !== null && scanHeight !== null) {
+        offset = relayHeight - scanHeight > 0 ? relayHeight - scanHeight : 0;
+      } else {
+        offset = scanHeight !== null && scanHeight !== void 0 ? scanHeight : 0;
+      }
+      return {
+        offset,
+        relayHeight,
+        scanHeight
+      };
+    } catch (err) {
+      console.error(`Failed to get migration block offset for ${this.chain}:`, err);
+      return {
+        offset: null,
+        relayHeight: null,
+        scanHeight: null
+      };
+    }
+  }
+  async getReferenda(params) {
+    const api = this.isLegacyGov ? _url.gov1ReferendumsApi : _url.gov2ReferendumsApi;
+    const referendaRes = await this.client.get(api, {
+      params
+    });
+    const data = referendaRes.data;
+    if (this.isLegacyGov) {
+      return {
+        ...data,
+        items: data.items.map(_utils.castDemocracyReferendumToReferendum)
+      };
+    }
+    return {
+      ...data,
+      items: data.items.map(ref => {
+        var _ref$trackInfo;
+        return {
+          ...ref,
+          version: 2,
+          trackInfo: {
+            ...ref.trackInfo,
+            name: (0, _utils.reformatTrackName)(((_ref$trackInfo = ref.trackInfo) === null || _ref$trackInfo === void 0 ? void 0 : _ref$trackInfo.name) || '')
+          }
+        };
+      })
+    };
+  }
+  async getReferendaDetails(id) {
+    const api = this.isLegacyGov ? _url.gov1ReferendumsApi : _url.gov2ReferendumsApi;
+    const referendaRes = await this.client.get(`${api}/${id}`);
+    let ref = referendaRes.data;
+    if (this.isLegacyGov) {
+      return (0, _utils.castDemocracyReferendumToReferendum)(ref);
+    }
+    ref = ref;
+    return {
+      ...ref,
+      version: 2,
+      trackInfo: {
+        ...ref.trackInfo,
+        name: (0, _utils.reformatTrackName)(ref.trackInfo.name)
+      }
+    };
+  }
+  async getTracks() {
+    const tracksRes = await this.client.get(_url.gov2TracksApi);
+    const formattedTracks = tracksRes.data.map(track => ({
+      ...track,
+      name: (0, _utils.reformatTrackName)(track.name)
+    }));
+    return [_utils.ALL_TRACK, ...formattedTracks];
+  }
+  async getReferendaWithTrack(trackId, params) {
+    const referendaRes = await this.client.get(_url.gov2TracksApi + `/${trackId}/referendums`, {
+      params
+    });
+    return {
+      ...referendaRes.data,
+      items: referendaRes.data.items.map(ref => {
+        if (ref.version === 1) {
+          return {
+            ...ref
+          };
+        }
+        return {
+          ...ref,
+          trackInfo: {
+            ...ref.trackInfo,
+            name: (0, _utils.reformatTrackName)(ref.trackInfo.name)
+          }
+        };
+      })
+    };
+  }
+  async getReferendaVotes(id) {
+    const api = this.isLegacyGov ? _url.gov1ReferendumsApi : _url.gov2ReferendumsApi;
+    const referendaVoteRes = await this.client.get(api + `/${id}/votes`);
+    return referendaVoteRes.data;
+  }
+  async getUserVotes(address, params) {
+    const userVoteRes = await this.client.get(`/users/${address}/votes`, {
+      params
+    });
+    return userVoteRes.data;
+  }
+  async findReferendumByValue(text) {
+    var _referendaRes$data, _referendaRes$data$de;
+    const referendaRes = await this.client.get('/search', {
+      params: {
+        text
+      }
+    });
+    if ((_referendaRes$data = referendaRes.data) !== null && _referendaRes$data !== void 0 && (_referendaRes$data$de = _referendaRes$data.democracyReferenda) !== null && _referendaRes$data$de !== void 0 && _referendaRes$data$de.length && this.isLegacyGov) {
+      const democracyReferenda = referendaRes.data.democracyReferenda.map(_utils.castDemocracyReferendumToReferendum);
+      return {
+        govReferenda: [...democracyReferenda]
+      };
+    }
+    return {
+      govReferenda: referendaRes.data.openGovReferenda
+    };
+  }
+}
+exports.SubsquareApiSdk = SubsquareApiSdk;

package/cjs/url.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.gov2TracksApi = exports.gov2ReferendumsApi = exports.gov1ReferendumsApi = void 0;
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+const gov2TracksApi = '/gov2/tracks';
+exports.gov2TracksApi = gov2TracksApi;
+const gov2ReferendumsApi = '/gov2/referendums';
+exports.gov2ReferendumsApi = gov2ReferendumsApi;
+const gov1ReferendumsApi = '/democracy/referendums';
+exports.gov1ReferendumsApi = gov1ReferendumsApi;

package/cjs/utils.js

@@ -0,0 +1,85 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.castDemocracyReferendumToReferendum = exports.ALL_TRACK_ID = exports.ALL_TRACK = void 0;
+exports.reformatTrackName = reformatTrackName;
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+const ALL_TRACK_ID = 'All';
+exports.ALL_TRACK_ID = ALL_TRACK_ID;
+const ALL_TRACK = {
+  id: ALL_TRACK_ID,
+  name: 'All tracks',
+  decisionPeriod: 0,
+  confirmPeriod: 0
+};
+exports.ALL_TRACK = ALL_TRACK;
+function reformatTrackName(input) {
+  if (!input) {
+    return '';
+  }
+  let str = input.replace(/[_-]/g, ' ');
+  str = str.replace(/([a-z])([A-Z])/g, '$1 $2');
+  return str.split(' ').filter(Boolean).map(word => word[0].toUpperCase() + word.slice(1).toLowerCase()).join(' ');
+}
+const castDemocracyReferendumToReferendum = ref => {
+  const {
+    call,
+    hash,
+    info,
+    meta,
+    state
+  } = ref.onchainData;
+  const enactmentAfter = ((meta === null || meta === void 0 ? void 0 : meta.delay) || 0) + ((meta === null || meta === void 0 ? void 0 : meta.end) || 0);
+  const enactment = {
+    after: enactmentAfter.toString()
+  };
+  const proposal = ref.onchainData.preImage ? ref.onchainData.preImage : {
+    call
+  };
+  const onChainData = {
+    ...ref.onchainData,
+    proposalHash: hash,
+    proposal,
+    meta,
+    info: {
+      decisionDeposit: {
+        who: '',
+        amount: '0'
+      },
+      submissionDeposit: {
+        who: '',
+        amount: '0'
+      },
+      enactment,
+      alarm: [],
+      submitted: 0,
+      democracy: info
+    }
+  };
+  return {
+    ...ref,
+    version: 1,
+    trackInfo: {
+      id: '-1',
+      name: 'Democracy',
+      decisionPeriod: 0,
+      confirmPeriod: 0
+    },
+    decisionDeposit: {
+      who: ''
+    },
+    enactment,
+    proposalHash: hash,
+    proposalCall: proposal.call,
+    state: {
+      ...state,
+      name: ref.state
+    },
+    onchainData: onChainData
+  };
+};
+exports.castDemocracyReferendumToReferendum = castDemocracyReferendumToReferendum;

package/detectOther.d.ts

@@ -0,0 +1,2 @@
+declare const _default: never[];
+export default _default;

package/detectOther.js

@@ -0,0 +1,6 @@
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// Empty template, auto-generated by @polkadot/dev
+
+export default [];

package/detectPackage.d.ts

@@ -0,0 +1 @@
+export {};

package/detectPackage.js

@@ -0,0 +1,9 @@
+// Copyright 2017-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// Do not edit, auto-generated by @polkadot/dev
+
+import { detectPackage } from '@polkadot/util';
+import others from "./detectOther.js";
+import { packageInfo } from "./packageInfo.js";
+detectPackage(packageInfo, null, others);

package/index.d.ts

@@ -0,0 +1,6 @@
+import './detectPackage';
+import { getSubsquareApi } from './bundle';
+export * from './bundle';
+export default getSubsquareApi;
+export * from './interface';
+export { ALL_TRACK_ID } from './utils';

package/index.js

@@ -0,0 +1,9 @@
+// Copyright 2017-2022 @subwallet/subwallet-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import "./detectPackage.js";
+import { getSubsquareApi } from "./bundle.js";
+export * from "./bundle.js";
+export default getSubsquareApi;
+export * from "./interface.js";
+export { ALL_TRACK_ID } from "./utils.js";

package/interface.d.ts

@@ -0,0 +1,378 @@
+export interface Referendum {
+    _id: string;
+    referendumIndex: number;
+    proposer: string;
+    title: string;
+    content: string;
+    version: number;
+    decisionDeposit: {
+        who: string;
+    };
+    trackInfo: TrackInfo;
+    enactment: {
+        after?: string;
+        at?: string;
+    };
+    proposalHash: string;
+    proposalCall: {
+        section: string;
+        method: string;
+    };
+    state: OnchainState;
+    allSpends?: SpendItem[];
+    onchainData: OnchainData;
+}
+export interface DemocracyReferendum {
+    _id: string;
+    referendumIndex: number;
+    indexer: Indexer;
+    contentType: string;
+    track: number;
+    createdAt: string;
+    updatedAt: string;
+    lastActivityAt: string;
+    edited: boolean;
+    stateSort: number;
+    polkassemblyCommentsCount: number;
+    polkassemblyId: number;
+    polkassemblyPostType: string;
+    contentHash: string;
+    dataSource: string;
+    polkassemblyContentHtml: string;
+    contentSummary: Record<string, unknown>;
+    isBoundDiscussion: boolean;
+    isFinal: boolean;
+    refToPost: Record<string, unknown>;
+    rootPost: Record<string, unknown>;
+    author: Record<string, unknown>;
+    commentsCount: number;
+    authors: string[];
+    reactions: unknown[];
+    proposer: string;
+    title: string;
+    content: string;
+    version: 1;
+    state: GovStatusKey;
+    onchainData: DemocracyOnchainData;
+}
+interface DemocracyMetadata {
+    end: number;
+    threshold: string;
+    delay: number;
+}
+export interface DemocracyOnChainInfo {
+    ongoing?: DemocracyReferendumOngoing;
+    finished?: DemocracyReferendumFinished;
+}
+export interface DemocracyReferendumOngoing {
+    end: number;
+    proposal: {
+        lookup: {
+            hash: string;
+            len: number;
+        };
+    };
+    threshold: 'SuperMajorityApprove' | 'SuperMajorityAgainst' | 'SimpleMajority';
+    delay: number;
+    tally: Tally;
+}
+export interface DemocracyReferendumFinished {
+    approved: boolean;
+    end: number;
+}
+interface DemocracyOnchainData {
+    timeline: RefTimelineItem[];
+    proposer: string;
+    hash: string;
+    call: {
+        args: ProposalArg[];
+        callIndex: string;
+        method: string;
+        section: string;
+    };
+    info: DemocracyOnChainInfo;
+    meta: DemocracyMetadata;
+    status?: DemocracyMetadata;
+    tally: Tally;
+    state: OnchainState;
+    preImage: Proposal;
+}
+export interface ReferendumDetail {
+    version: number;
+    _id: string;
+    referendumIndex: number;
+    indexer: Indexer;
+    proposer: string;
+    title: string;
+    content: string;
+    contentType: string;
+    track: number;
+    createdAt: string;
+    updatedAt: string;
+    lastActivityAt: string;
+    edited: boolean;
+    state: OnchainState;
+    stateSort: number;
+    polkassemblyCommentsCount: number;
+    polkassemblyId: number;
+    polkassemblyPostType: string;
+    contentHash: string;
+    dataSource: string;
+    polkassemblyContentHtml: string;
+    contentSummary: Record<string, unknown>;
+    allSpends?: SpendItem[];
+    isBoundDiscussion: boolean;
+    isFinal: boolean;
+    isTreasuryProposal: boolean;
+    isTreasuryV1: boolean;
+    onchainData: OnchainData;
+    refToPost: Record<string, unknown>;
+    rootPost: Record<string, unknown>;
+    trackInfo: TrackInfo;
+    author: Record<string, unknown>;
+    commentsCount: number;
+    authors: string[];
+    reactions: unknown[];
+}
+interface BaseSpendItem {
+    isSpendLocal: boolean;
+    amount: string;
+    beneficiary: {
+        chain: string;
+        address: string;
+        pubKey: string;
+    };
+    beneficiaryLocation?: {
+        name: string;
+        type: string;
+        value: {
+            v3?: {
+                parents: number;
+                interior: Record<string, unknown>;
+            };
+            v4?: {
+                parents: number;
+                interior: Record<string, unknown>;
+            };
+        };
+    };
+    validFrom?: number | null;
+    after?: unknown;
+}
+interface LocalSpendItem extends BaseSpendItem {
+    isSpendLocal: true;
+    type: string;
+    symbol: string;
+}
+interface RemoteSpendItem extends BaseSpendItem {
+    isSpendLocal: false;
+    assetKind: {
+        chain: string;
+        type: string;
+        symbol: string;
+    };
+}
+export declare type SpendItem = LocalSpendItem | RemoteSpendItem;
+export interface RefTimelineItem {
+    _id: string;
+    referendumIndex: number;
+    indexer: {
+        blockHeight: number;
+        blockHash: string;
+        blockTime: number;
+        extrinsicIndex?: number;
+        eventIndex: number;
+    };
+    name: string;
+    method: string;
+    args: Record<string, unknown>;
+}
+export interface Tally {
+    ayes: string;
+    nays: string;
+    electorate: string;
+    support: string;
+    turnout: string;
+}
+export interface Proposal {
+    call: {
+        args: ProposalArg[];
+        callIndex: string;
+        method: string;
+        section: string;
+    };
+    indexer: {
+        blockHeight: number;
+        blockHash: string;
+        blockTime: number;
+        extrinsicIndex?: number;
+        eventIndex: number;
+    };
+    shorten: boolean;
+}
+interface ProposalArg {
+    name: string;
+    type: string;
+    value: any;
+}
+interface Reciprocal {
+    factor: number;
+    xOffset: number;
+    yOffset: number;
+}
+interface LinearDecreasing {
+    ceil: number;
+    floor: number;
+    length: number;
+}
+interface MinApproval {
+    reciprocal?: Reciprocal;
+    linearDecreasing?: LinearDecreasing;
+}
+export interface TrackInfo {
+    decisionPeriod: number;
+    confirmPeriod: number;
+    name: string;
+    minApproval?: MinApproval;
+    id: string;
+}
+interface OnchainInfo {
+    decisionDeposit: {
+        amount: string;
+        who: string;
+    };
+    submissionDeposit: {
+        amount: string;
+        who: string;
+    };
+    enactment: {
+        after?: string;
+        at?: string;
+    };
+    deciding?: {
+        since: number;
+    };
+    state?: {
+        indexer?: {
+            blockHeight?: number;
+        };
+    };
+    alarm: number[];
+    submitted: number;
+    democracy?: DemocracyOnChainInfo;
+}
+interface Indexer {
+    blockHeight: number;
+    blockHash: string;
+    index: number;
+    blockTime: number;
+}
+export interface OnchainState {
+    indexer: Indexer;
+    name: GovStatusKey;
+    threshold?: string;
+}
+export interface OnchainData {
+    proposalHash: string;
+    timeline: RefTimelineItem[];
+    tally: Tally;
+    proposal: Proposal;
+    info: OnchainInfo;
+    state?: OnchainState;
+    meta?: DemocracyMetadata;
+    status?: DemocracyMetadata;
+    treasuryInfo?: {
+        amount: string;
+        beneficiary: string;
+    };
+}
+export interface ReferendaResponse {
+    items: Referendum[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface DemocracyReferendaResponse {
+    items: DemocracyReferendum[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface ReferendaQueryParams {
+    page?: number;
+    page_size?: number;
+    is_treasury?: boolean;
+    ongoing?: boolean;
+    status?: string;
+    simple?: boolean;
+}
+export interface ReferendaQueryParamsWithTrack {
+    page?: number;
+    page_size?: number;
+    ongoing?: boolean;
+    status?: string;
+    simple?: boolean;
+}
+export interface UserVotesParams {
+    page?: number;
+    page_size?: number;
+    includes_title?: number;
+}
+export interface ReferendumVoteDetail {
+    referendumIndex: number;
+    account: string;
+    target?: string;
+    isDelegating: boolean;
+    isStandard: boolean;
+    isSplit: boolean;
+    isSplitAbstain: boolean;
+    balance?: string;
+    aye?: boolean;
+    conviction: number;
+    votes?: string;
+    abstainBalance?: string;
+    abstainVotes?: string;
+    ayeBalance?: string;
+    ayeVotes?: string;
+    nayBalance?: string;
+    nayVotes?: string;
+    delegations?: {
+        votes: string;
+        capital: string;
+    };
+    queryAt: number;
+}
+export declare enum GovStatusKey {
+    ALL = "All",
+    PREPARING = "Preparing",
+    DECIDING = "Deciding",
+    CONFIRMING = "Confirming",
+    QUEUEING = "Queueing",
+    APPROVED = "Approved",
+    EXECUTED = "Executed",
+    REJECTED = "Rejected",
+    TIMEDOUT = "TimedOut",
+    CANCELLED = "Cancelled",
+    KILLED = "Killed",
+    STARTED = "Started",
+    PASSED = "Passed",
+    NOTPASSED = "NotPassed"
+}
+export declare const GOV_PREPARING_STATES: GovStatusKey[];
+export declare const GOV_ONGOING_STATES: GovStatusKey[];
+export declare const GOV_COMPLETED_STATES: GovStatusKey[];
+export declare const GOV_COMPLETED_SUCCESS_STATES: GovStatusKey[];
+export declare const GOV_COMPLETED_FAILED_STATES: GovStatusKey[];
+export declare type ReadableStreamReadResult<T> = {
+    done: false;
+    value: T;
+} | {
+    done: true;
+    value?: undefined;
+};
+export interface MigrationBlockOffset {
+    offset: number | null;
+    relayHeight: number | null;
+    scanHeight: number | null;
+}
+export {};

package/interface.js

@@ -0,0 +1,33 @@
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+/* ReferendumVote */
+
+/* ReferendumVote */
+
+/* Gov Status */
+
+export let GovStatusKey;
+(function (GovStatusKey) {
+  GovStatusKey["ALL"] = "All";
+  GovStatusKey["PREPARING"] = "Preparing";
+  GovStatusKey["DECIDING"] = "Deciding";
+  GovStatusKey["CONFIRMING"] = "Confirming";
+  GovStatusKey["QUEUEING"] = "Queueing";
+  GovStatusKey["APPROVED"] = "Approved";
+  GovStatusKey["EXECUTED"] = "Executed";
+  GovStatusKey["REJECTED"] = "Rejected";
+  GovStatusKey["TIMEDOUT"] = "TimedOut";
+  GovStatusKey["CANCELLED"] = "Cancelled";
+  GovStatusKey["KILLED"] = "Killed";
+  GovStatusKey["STARTED"] = "Started";
+  GovStatusKey["PASSED"] = "Passed";
+  GovStatusKey["NOTPASSED"] = "NotPassed";
+})(GovStatusKey || (GovStatusKey = {}));
+export const GOV_PREPARING_STATES = [GovStatusKey.PREPARING, GovStatusKey.QUEUEING];
+export const GOV_ONGOING_STATES = [GovStatusKey.PREPARING, GovStatusKey.DECIDING, GovStatusKey.CONFIRMING, GovStatusKey.QUEUEING, GovStatusKey.STARTED];
+export const GOV_COMPLETED_STATES = [GovStatusKey.APPROVED, GovStatusKey.EXECUTED, GovStatusKey.REJECTED, GovStatusKey.TIMEDOUT, GovStatusKey.CANCELLED, GovStatusKey.KILLED, GovStatusKey.PASSED, GovStatusKey.NOTPASSED];
+export const GOV_COMPLETED_SUCCESS_STATES = [GovStatusKey.APPROVED, GovStatusKey.EXECUTED, GovStatusKey.PASSED];
+export const GOV_COMPLETED_FAILED_STATES = [GovStatusKey.REJECTED, GovStatusKey.TIMEDOUT, GovStatusKey.CANCELLED, GovStatusKey.KILLED, GovStatusKey.NOTPASSED];
+
+/* Gov Status */

package/package.json

@@ -0,0 +1,80 @@
+{
+  "bugs": "https://github.com/Koniverse/Subwallet-V2/issues",
+  "description": "Subsquare API SDK for Subwallet",
+  "homepage": "https://github.com/Koniverse/Subwallet-V2/tree/master/packages/subsquare-api-sdk#readme",
+  "license": "Apache-2.0",
+  "name": "@subwallet/subsquare-api-sdk",
+  "repository": {
+    "directory": "packages/subsquare-api-sdk",
+    "type": "git",
+    "url": "https://github.com/Koniverse/Subwallet-V2.git"
+  },
+  "sideEffects": [
+    "./detectPackage.js",
+    "./cjs/detectPackage.js"
+  ],
+  "version": "1.3.70-2",
+  "type": "module",
+  "main": "./cjs/build/index.js",
+  "module": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "exports": {
+    "./cjs/package.json": "./cjs/package.json",
+    "./cjs/*": "./cjs/*.js",
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./cjs/index.js",
+      "default": "./index.js"
+    },
+    "./bundle": {
+      "types": "./bundle.d.ts",
+      "require": "./cjs/bundle.js",
+      "default": "./bundle.js"
+    },
+    "./detectOther": {
+      "types": "./detectOther.d.ts",
+      "require": "./cjs/detectOther.js",
+      "default": "./detectOther.js"
+    },
+    "./detectPackage": {
+      "types": "./detectPackage.d.ts",
+      "require": "./cjs/detectPackage.js",
+      "default": "./detectPackage.js"
+    },
+    "./interface": {
+      "types": "./interface.d.ts",
+      "require": "./cjs/interface.js",
+      "default": "./interface.js"
+    },
+    "./package.json": "./package.json",
+    "./packageInfo.js": {
+      "types": "./packageInfo.d.ts",
+      "require": "./cjs/packageInfo.js",
+      "default": "./packageInfo.js"
+    },
+    "./packageInfo": {
+      "types": "./packageInfo.d.ts",
+      "require": "./cjs/packageInfo.js",
+      "default": "./packageInfo.js"
+    },
+    "./subsquare-sdk": {
+      "types": "./subsquare-sdk.d.ts",
+      "require": "./cjs/subsquare-sdk.js",
+      "default": "./subsquare-sdk.js"
+    },
+    "./url": {
+      "types": "./url.d.ts",
+      "require": "./cjs/url.js",
+      "default": "./url.js"
+    },
+    "./utils": {
+      "types": "./utils.d.ts",
+      "require": "./cjs/utils.js",
+      "default": "./utils.js"
+    }
+  },
+  "dependencies": {
+    "@polkadot/util": "^13.4.3",
+    "axios": "^1.11.0"
+  }
+}

package/packageInfo.d.ts

@@ -0,0 +1,6 @@
+export declare const packageInfo: {
+    name: string;
+    path: string;
+    type: string;
+    version: string;
+};

package/packageInfo.js

@@ -0,0 +1,11 @@
+// Copyright 2017-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+// Do not edit, auto-generated by @polkadot/dev
+
+export const packageInfo = {
+  name: '@subwallet/subsquare-api-sdk',
+  path: (import.meta && import.meta.url) ? new URL(import.meta.url).pathname.substring(0, new URL(import.meta.url).pathname.lastIndexOf('/') + 1) : 'auto',
+  type: 'esm',
+  version: '1.3.70-2'
+};

package/subsquare-sdk.d.ts

@@ -0,0 +1,19 @@
+import { MigrationBlockOffset, ReferendaQueryParams, ReferendaQueryParamsWithTrack, ReferendaResponse, Referendum, ReferendumDetail, ReferendumVoteDetail, TrackInfo, UserVotesParams } from './interface';
+export declare class SubsquareApiSdk {
+    private client;
+    private static instances;
+    isLegacyGov: boolean;
+    private chain;
+    private constructor();
+    static getInstance(chain: string): SubsquareApiSdk;
+    getMigrationBlockOffset(blockTime: number): Promise<MigrationBlockOffset>;
+    getReferenda(params?: ReferendaQueryParams): Promise<ReferendaResponse>;
+    getReferendaDetails(id: string): Promise<ReferendumDetail>;
+    getTracks(): Promise<TrackInfo[]>;
+    getReferendaWithTrack(trackId: number, params?: ReferendaQueryParamsWithTrack): Promise<ReferendaResponse>;
+    getReferendaVotes(id: string): Promise<ReferendumVoteDetail[]>;
+    getUserVotes(address: string, params: UserVotesParams): Promise<ReferendumVoteDetail[]>;
+    findReferendumByValue(text: string): Promise<{
+        govReferenda: Referendum[];
+    }>;
+}

package/subsquare-sdk.js

@@ -0,0 +1,184 @@
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+import axios from 'axios';
+import { gov1ReferendumsApi, gov2ReferendumsApi, gov2TracksApi } from "./url.js";
+import { ALL_TRACK, castDemocracyReferendumToReferendum, reformatTrackName } from "./utils.js";
+const specialBaseUrls = {
+  vara: 'https://vara.subsquare.io/api',
+  acala: 'https://acala.subsquare.io/api',
+  centrifuge: 'https://centrifuge.subsquare.io/api',
+  laos: 'https://laos.subsquare.io/api/',
+  interlay: 'https://interlay.subsquare.io/api',
+  karura: 'https://karura.subsquare.io/api',
+  kintsugi: 'https://kintsugi.subsquare.io/api'
+};
+const LegacyGovChains = ['ajuna', 'astar', 'phala', 'heima', 'acala', 'centrifuge', 'interlay', 'laos', 'karura', 'kintsugi'];
+export class SubsquareApiSdk {
+  static instances = new Map();
+  isLegacyGov = false;
+  constructor(chain) {
+    const baseURL = specialBaseUrls[chain] || `https://${chain}-api.subsquare.io`;
+    this.isLegacyGov = LegacyGovChains.includes(chain);
+    this.client = axios.create({
+      baseURL
+    });
+    this.chain = chain;
+  }
+  static getInstance(chain) {
+    if (!this.instances.has(chain)) {
+      this.instances.set(chain, new SubsquareApiSdk(chain));
+    }
+    return this.instances.get(chain);
+  }
+  async getMigrationBlockOffset(blockTime) {
+    try {
+      const urls = [`/stream/relay-chain-height?interval=${blockTime * 1000}`, `/stream/scan-height?interval=${blockTime * 1000}`];
+      const results = await Promise.allSettled(urls.map(async url => {
+        const res = await fetch(new URL(url, this.client.defaults.baseURL));
+        if (!res.body) {
+          throw new Error('Response body is null');
+        }
+        const reader = res.body.getReader();
+        const decoder = new TextDecoder();
+
+        // @ts-ignore
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const readResult = await reader.read();
+        const {
+          done,
+          value
+        } = readResult;
+        if (done || !value) {
+          throw new Error('No data from stream');
+        }
+        const text = decoder.decode(value);
+        const data = JSON.parse(text);
+        return data.value;
+      }));
+      const [relayResult, scanResult] = results;
+      const relayHeight = relayResult.status === 'fulfilled' ? relayResult.value : null;
+      const scanHeight = scanResult.status === 'fulfilled' ? scanResult.value : null;
+      let offset;
+      if (relayHeight !== null && scanHeight !== null) {
+        offset = relayHeight - scanHeight > 0 ? relayHeight - scanHeight : 0;
+      } else {
+        offset = scanHeight !== null && scanHeight !== void 0 ? scanHeight : 0;
+      }
+      return {
+        offset,
+        relayHeight,
+        scanHeight
+      };
+    } catch (err) {
+      console.error(`Failed to get migration block offset for ${this.chain}:`, err);
+      return {
+        offset: null,
+        relayHeight: null,
+        scanHeight: null
+      };
+    }
+  }
+  async getReferenda(params) {
+    const api = this.isLegacyGov ? gov1ReferendumsApi : gov2ReferendumsApi;
+    const referendaRes = await this.client.get(api, {
+      params
+    });
+    const data = referendaRes.data;
+    if (this.isLegacyGov) {
+      return {
+        ...data,
+        items: data.items.map(castDemocracyReferendumToReferendum)
+      };
+    }
+    return {
+      ...data,
+      items: data.items.map(ref => {
+        var _ref$trackInfo;
+        return {
+          ...ref,
+          version: 2,
+          trackInfo: {
+            ...ref.trackInfo,
+            name: reformatTrackName(((_ref$trackInfo = ref.trackInfo) === null || _ref$trackInfo === void 0 ? void 0 : _ref$trackInfo.name) || '')
+          }
+        };
+      })
+    };
+  }
+  async getReferendaDetails(id) {
+    const api = this.isLegacyGov ? gov1ReferendumsApi : gov2ReferendumsApi;
+    const referendaRes = await this.client.get(`${api}/${id}`);
+    let ref = referendaRes.data;
+    if (this.isLegacyGov) {
+      return castDemocracyReferendumToReferendum(ref);
+    }
+    ref = ref;
+    return {
+      ...ref,
+      version: 2,
+      trackInfo: {
+        ...ref.trackInfo,
+        name: reformatTrackName(ref.trackInfo.name)
+      }
+    };
+  }
+  async getTracks() {
+    const tracksRes = await this.client.get(gov2TracksApi);
+    const formattedTracks = tracksRes.data.map(track => ({
+      ...track,
+      name: reformatTrackName(track.name)
+    }));
+    return [ALL_TRACK, ...formattedTracks];
+  }
+  async getReferendaWithTrack(trackId, params) {
+    const referendaRes = await this.client.get(gov2TracksApi + `/${trackId}/referendums`, {
+      params
+    });
+    return {
+      ...referendaRes.data,
+      items: referendaRes.data.items.map(ref => {
+        if (ref.version === 1) {
+          return {
+            ...ref
+          };
+        }
+        return {
+          ...ref,
+          trackInfo: {
+            ...ref.trackInfo,
+            name: reformatTrackName(ref.trackInfo.name)
+          }
+        };
+      })
+    };
+  }
+  async getReferendaVotes(id) {
+    const api = this.isLegacyGov ? gov1ReferendumsApi : gov2ReferendumsApi;
+    const referendaVoteRes = await this.client.get(api + `/${id}/votes`);
+    return referendaVoteRes.data;
+  }
+  async getUserVotes(address, params) {
+    const userVoteRes = await this.client.get(`/users/${address}/votes`, {
+      params
+    });
+    return userVoteRes.data;
+  }
+  async findReferendumByValue(text) {
+    var _referendaRes$data, _referendaRes$data$de;
+    const referendaRes = await this.client.get('/search', {
+      params: {
+        text
+      }
+    });
+    if ((_referendaRes$data = referendaRes.data) !== null && _referendaRes$data !== void 0 && (_referendaRes$data$de = _referendaRes$data.democracyReferenda) !== null && _referendaRes$data$de !== void 0 && _referendaRes$data$de.length && this.isLegacyGov) {
+      const democracyReferenda = referendaRes.data.democracyReferenda.map(castDemocracyReferendumToReferendum);
+      return {
+        govReferenda: [...democracyReferenda]
+      };
+    }
+    return {
+      govReferenda: referendaRes.data.openGovReferenda
+    };
+  }
+}

package/url.d.ts

@@ -0,0 +1,3 @@
+export declare const gov2TracksApi = "/gov2/tracks";
+export declare const gov2ReferendumsApi = "/gov2/referendums";
+export declare const gov1ReferendumsApi = "/democracy/referendums";

package/url.js

@@ -0,0 +1,6 @@
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+export const gov2TracksApi = '/gov2/tracks';
+export const gov2ReferendumsApi = '/gov2/referendums';
+export const gov1ReferendumsApi = '/democracy/referendums';

package/utils.d.ts

@@ -0,0 +1,5 @@
+import { DemocracyReferendum, Referendum, ReferendumDetail, TrackInfo } from './interface';
+export declare const ALL_TRACK_ID = "All";
+export declare const ALL_TRACK: TrackInfo;
+export declare function reformatTrackName(input: string): string;
+export declare const castDemocracyReferendumToReferendum: <T extends Referendum | ReferendumDetail>(ref: DemocracyReferendum) => T;

package/utils.js

@@ -0,0 +1,75 @@
+// Copyright 2019-2022 @subwallet/subsquare-api-sdk authors & contributors
+// SPDX-License-Identifier: Apache-2.0
+
+export const ALL_TRACK_ID = 'All';
+export const ALL_TRACK = {
+  id: ALL_TRACK_ID,
+  name: 'All tracks',
+  decisionPeriod: 0,
+  confirmPeriod: 0
+};
+export function reformatTrackName(input) {
+  if (!input) {
+    return '';
+  }
+  let str = input.replace(/[_-]/g, ' ');
+  str = str.replace(/([a-z])([A-Z])/g, '$1 $2');
+  return str.split(' ').filter(Boolean).map(word => word[0].toUpperCase() + word.slice(1).toLowerCase()).join(' ');
+}
+export const castDemocracyReferendumToReferendum = ref => {
+  const {
+    call,
+    hash,
+    info,
+    meta,
+    state
+  } = ref.onchainData;
+  const enactmentAfter = ((meta === null || meta === void 0 ? void 0 : meta.delay) || 0) + ((meta === null || meta === void 0 ? void 0 : meta.end) || 0);
+  const enactment = {
+    after: enactmentAfter.toString()
+  };
+  const proposal = ref.onchainData.preImage ? ref.onchainData.preImage : {
+    call
+  };
+  const onChainData = {
+    ...ref.onchainData,
+    proposalHash: hash,
+    proposal,
+    meta,
+    info: {
+      decisionDeposit: {
+        who: '',
+        amount: '0'
+      },
+      submissionDeposit: {
+        who: '',
+        amount: '0'
+      },
+      enactment,
+      alarm: [],
+      submitted: 0,
+      democracy: info
+    }
+  };
+  return {
+    ...ref,
+    version: 1,
+    trackInfo: {
+      id: '-1',
+      name: 'Democracy',
+      decisionPeriod: 0,
+      confirmPeriod: 0
+    },
+    decisionDeposit: {
+      who: ''
+    },
+    enactment,
+    proposalHash: hash,
+    proposalCall: proposal.call,
+    state: {
+      ...state,
+      name: ref.state
+    },
+    onchainData: onChainData
+  };
+};