@sabaaa1/common 0.1.7 → 0.1.14

package/API/seedless-calls.d.ts

@@ -0,0 +1,53 @@
+interface SeedlessInitProps {
+    sessionToken: string;
+    ethereumAddress: string;
+    ciphertextB64: string;
+    ivB64: string;
+    saltMnemonicB64: string;
+    saltSharesB64: string;
+    shareMongoB64: string;
+    shareMongoIvB64: string;
+    passwordHashB64: string;
+    passwordSaltB64: string;
+}
+interface SeedlessInitRes {
+    success: boolean;
+}
+export declare const seedlessInit: (payload: SeedlessInitProps) => Promise<SeedlessInitRes>;
+interface SeedlessBackupProps {
+    sessionToken: string;
+}
+interface SeedlessBackupRes {
+    success: boolean;
+    ciphertextB64: string;
+    ivB64: string;
+    saltMnemonicB64: string;
+    saltSharesB64: string;
+    shareMongoB64: string;
+    shareMongoIvB64: string;
+}
+export declare const seedlessBackup: (payload: SeedlessBackupProps) => Promise<SeedlessBackupRes>;
+interface SeedlessStatusProps {
+    sessionToken: string;
+}
+interface SeedlessStatusRes {
+    success: boolean;
+    isFirstLogin: boolean;
+}
+export declare const seedlessStatus: (payload: SeedlessStatusProps) => Promise<SeedlessStatusRes>;
+interface SeedlessCheckPasswordProps {
+    sessionToken: string;
+    password: string;
+}
+interface SeedlessCheckPasswordRes {
+    success: boolean;
+}
+export declare const seedlessCheckPassword: (payload: SeedlessCheckPasswordProps) => Promise<SeedlessCheckPasswordRes>;
+interface SeedlessSaltProps {
+    sessionToken: string;
+}
+interface SeedlessSaltRes {
+    passwordSaltB64: string;
+}
+export declare const seedlessSalt: (payload: SeedlessSaltProps) => Promise<SeedlessSaltRes>;
+export {};

package/API/seedless-calls.mjs

@@ -0,0 +1,12 @@
+import { DATA_SERVER_URL as e } from "./getServerURL.mjs";
+import { DATA_SERVER_CONFIG as t } from "../constants/server.constants.mjs";
+import { httpClient as o } from "../data-structures/http/HttpClient.mjs";
+import "axios";
+const l = async (s) => o.post(`${e}${t.seedlessInit}`, s), p = async (s) => o.post(`${e}${t.seedlessBackup}`, s), d = async (s) => o.post(`${e}${t.seedlessStatus}`, s), $ = async (s) => o.post(`${e}${t.seedlessCheckPassword}`, s), u = async (s) => o.post(`${e}${t.seedlessSalt}`, s);
+export {
+  p as seedlessBackup,
+  $ as seedlessCheckPassword,
+  l as seedlessInit,
+  u as seedlessSalt,
+  d as seedlessStatus
+};

package/API/send-telegram-callback.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../constants/server.constants.cjs"),s=require("./getServerURL.cjs"),n=require("axios"),c=async({ethereumAddress:e,telegramUser:r})=>{const{data:t}=await n.post(`${s.DATA_SERVER_URL}${a.DATA_SERVER_CONFIG.getTelegramCallback}`,{ethereumAddress:e,telegramUser:r});return t};exports.sendTelegramCallback=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../constants/server.constants.cjs"),a=require("./getServerURL.cjs"),n=require("../data-structures/http/HttpClient.cjs");require("axios");const l=async({ethereumAddress:e,telegramUser:t})=>await n.httpClient.post(`${a.DATA_SERVER_URL}${r.DATA_SERVER_CONFIG.getTelegramCallback}`,{ethereumAddress:e,telegramUser:t});exports.sendTelegramCallback=l;

package/API/send-telegram-callback.mjs

@@ -1,13 +1,11 @@
-import { DATA_SERVER_CONFIG as t } from "../constants/server.constants.mjs";
-import { DATA_SERVER_URL as e } from "./getServerURL.mjs";
-import m from "axios";
-const i = async ({ ethereumAddress: a, telegramUser: o }) => {
-  const { data: r } = await m.post(`${e}${t.getTelegramCallback}`, {
-    ethereumAddress: a,
-    telegramUser: o
-  });
-  return r;
-};
+import { DATA_SERVER_CONFIG as r } from "../constants/server.constants.mjs";
+import { DATA_SERVER_URL as o } from "./getServerURL.mjs";
+import { httpClient as e } from "../data-structures/http/HttpClient.mjs";
+import "axios";
+const c = async ({ ethereumAddress: t, telegramUser: a }) => await e.post(`${o}${r.getTelegramCallback}`, {
+  ethereumAddress: t,
+  telegramUser: a
+});
 export {
-  i as sendTelegramCallback
+  c as sendTelegramCallback
 };

package/API/simulate-batch-tx.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./getServerURL.cjs"),a=require("../constants/server.constants.cjs"),c=require("axios"),o=async(e,t)=>{const{data:r}=await c.post(`${s.getServerURL(e)}${a.API_CONFIG.ROUTES.simulateBatchTx}`,{batchCalls:t});return r};exports.simulateBatchTx=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./getServerURL.cjs"),s=require("../constants/server.constants.cjs"),n=require("../data-structures/http/HttpClient.cjs");require("axios");const i=async(e,t)=>await n.httpClient.post(`${r.getServerURL(e)}${s.API_CONFIG.ROUTES.simulateBatchTx}`,{batchCalls:t});exports.simulateBatchTx=i;

package/API/simulate-batch-tx.mjs

@@ -1,15 +1,13 @@
-import { getServerURL as a } from "./getServerURL.mjs";
-import { API_CONFIG as m } from "../constants/server.constants.mjs";
-import e from "axios";
-const p = async (t, o) => {
-  const { data: r } = await e.post(
-    `${a(t)}${m.ROUTES.simulateBatchTx}`,
-    {
-      batchCalls: o
-    }
-  );
-  return r;
-};
+import { getServerURL as o } from "./getServerURL.mjs";
+import { API_CONFIG as e } from "../constants/server.constants.mjs";
+import { httpClient as s } from "../data-structures/http/HttpClient.mjs";
+import "axios";
+const c = async (t, r) => await s.post(
+  `${o(t)}${e.ROUTES.simulateBatchTx}`,
+  {
+    batchCalls: r
+  }
+);
 export {
-  p as simulateBatchTx
+  c as simulateBatchTx
 };

package/API/solana-calls.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("../data-structures/http/HttpClient.cjs");require("axios");const r=require("../constants/server.constants.cjs"),n=require("./getServerURL.cjs"),i=async(e,t)=>s.httpClient.post(`${n.getServerURL(e)}${r.API_CONFIG.ROUTES.generateProoflessDepositLimitless}`,t),o=async(e,t)=>s.httpClient.post(`${n.getServerURL(e)}${r.API_CONFIG.ROUTES.generateMultiPaymentDepositLimitless}`,t),l=async(e,t)=>s.httpClient.post(`${n.getServerURL(e)}${r.API_CONFIG.ROUTES.generateAddAccessToken}`,t);exports.generateAddAccessToken=l;exports.generateMultiPaymentDepositLimitless=o;exports.generateProoflessDepositLimitless=i;

package/API/solana-calls.d.ts

@@ -0,0 +1,34 @@
+import { AnchorStealthAddressStructure } from '../types/circom-data.types';
+interface GenerateProoflessDepositLimitlessInput {
+    payer: string;
+    ethereumAddress: string;
+    mint: string;
+    amount: string;
+    stealthAddressStructure: AnchorStealthAddressStructure;
+}
+interface GenerateMultiPaymentDepositLimitlessInput {
+    payer: string;
+    ethereumAddress: string;
+    mint: string;
+    amounts: string[];
+    stealthAddressStructure: AnchorStealthAddressStructure;
+}
+interface GenerateProoflessDepositLimitlessOutput {
+    serializedTransaction: string;
+    blockhash: string;
+    lastValidBlockHeight: number;
+}
+export declare const generateProoflessDepositLimitless: (chainId: number, input: GenerateProoflessDepositLimitlessInput) => Promise<GenerateProoflessDepositLimitlessOutput>;
+export declare const generateMultiPaymentDepositLimitless: (chainId: number, input: GenerateMultiPaymentDepositLimitlessInput) => Promise<GenerateProoflessDepositLimitlessOutput>;
+interface GenerateAddTokenPublicKeyInput {
+    payer: string;
+    accessKey: string;
+    ethereumAddress: string;
+}
+interface GenerateAddAccessTokenOutput {
+    serializedTransaction: string;
+    blockhash: string;
+    lastValidBlockHeight: number;
+}
+export declare const generateAddAccessToken: (chainId: number, input: GenerateAddTokenPublicKeyInput) => Promise<GenerateAddAccessTokenOutput>;
+export {};

package/API/solana-calls.mjs

@@ -0,0 +1,19 @@
+import { httpClient as s } from "../data-structures/http/HttpClient.mjs";
+import "axios";
+import { API_CONFIG as o } from "../constants/server.constants.mjs";
+import { getServerURL as r } from "./getServerURL.mjs";
+const a = async (e, t) => s.post(
+  `${r(e)}${o.ROUTES.generateProoflessDepositLimitless}`,
+  t
+), c = async (e, t) => s.post(
+  `${r(e)}${o.ROUTES.generateMultiPaymentDepositLimitless}`,
+  t
+), l = async (e, t) => s.post(
+  `${r(e)}${o.ROUTES.generateAddAccessToken}`,
+  t
+);
+export {
+  l as generateAddAccessToken,
+  c as generateMultiPaymentDepositLimitless,
+  a as generateProoflessDepositLimitless
+};

package/API/tenderly.api.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../constants/chains.constants.cjs"),s=require("axios"),h="7o1iPUgCIjLI0rSxj2yuz9-Z3052uUc4",u="hinkal-org",y="project",m=`https://api.tenderly.co/api/v1/account/${u}/project/${y}`,c={"X-Access-Key":h},o=async t=>{const{data:a}=await s.post(`${m}/simulate`,{...t},{headers:c});return a},r={[e.chainIds.optimism]:"https://optimism.gateway.tenderly.co/2A3r4RCMoAZVmQOpNqRO29",[e.chainIds.base]:"https://base.gateway.tenderly.co/73UtIBn1YiCyhqRJuKTkWl",[e.chainIds.ethMainnet]:"https://mainnet.gateway.tenderly.co/SW3mROrzKEQYSq3RkStJ7",[e.chainIds.avalanche]:"https://avalanche.gateway.tenderly.co/2YdoJTNLCUHfzwvqIUVgwZ",[e.chainIds.arbMainnet]:"https://arbitrum.gateway.tenderly.co/4dUF2wEnsmvFw9fqLpoLga",[e.chainIds.polygon]:"https://polygon.gateway.tenderly.co/32hCaUScB41nXgyzCmeDVu"},i=async(t,a)=>{const{data:n}=await s.post(r[t],{jsonrpc:"2.0",id:0,method:"tenderly_simulateTransaction",params:a.params},{headers:c});return n},d=async(t,a)=>{const{data:n}=await s.post(r[t],{jsonrpc:"2.0",id:0,method:"tenderly_simulateBundle",params:a.params},{headers:c});return n},p=async(t,a,n)=>{const{data:l}=await s.post(r[t],{jsonrpc:"2.0",id:0,method:"tenderly_getStorageChanges",params:[{address:a,offset:n}]},{headers:c});return l},g={rpcGetStorageChanges:p,rpcSimulateTransaction:i,rpcSimulateBundle:d,simulateTx:o};exports.WALLET_API=g;exports.rpcGetStorageChanges=p;exports.rpcSimulateBundle=d;exports.rpcSimulateTransaction=i;exports.simulateTx=o;exports.tenderlyRpcLinks=r;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../constants/chains.constants.cjs"),s=require("../data-structures/http/HttpClient.cjs");require("axios");const d="7o1iPUgCIjLI0rSxj2yuz9-Z3052uUc4",h="hinkal-org",u="project",y=`https://api.tenderly.co/api/v1/account/${h}/project/${u}`,a={"X-Access-Key":d},c=async t=>await s.httpClient.post(`${y}/simulate`,{...t},{headers:a}),r={[n.chainIds.optimism]:"https://optimism.gateway.tenderly.co/2A3r4RCMoAZVmQOpNqRO29",[n.chainIds.base]:"https://base.gateway.tenderly.co/73UtIBn1YiCyhqRJuKTkWl",[n.chainIds.ethMainnet]:"https://mainnet.gateway.tenderly.co/SW3mROrzKEQYSq3RkStJ7",[n.chainIds.avalanche]:"https://avalanche.gateway.tenderly.co/2YdoJTNLCUHfzwvqIUVgwZ",[n.chainIds.arbMainnet]:"https://arbitrum.gateway.tenderly.co/4dUF2wEnsmvFw9fqLpoLga",[n.chainIds.polygon]:"https://polygon.gateway.tenderly.co/32hCaUScB41nXgyzCmeDVu"},i=async(t,e)=>await s.httpClient.post(r[t],{jsonrpc:"2.0",id:0,method:"tenderly_simulateTransaction",params:e.params},{headers:a}),p=async(t,e)=>await s.httpClient.post(r[t],{jsonrpc:"2.0",id:0,method:"tenderly_simulateBundle",params:e.params},{headers:a}),l=async(t,e,o)=>await s.httpClient.post(r[t],{jsonrpc:"2.0",id:0,method:"tenderly_getStorageChanges",params:[{address:e,offset:o}]},{headers:a}),m={rpcGetStorageChanges:l,rpcSimulateTransaction:i,rpcSimulateBundle:p,simulateTx:c};exports.WALLET_API=m;exports.rpcGetStorageChanges=l;exports.rpcSimulateBundle=p;exports.rpcSimulateTransaction=i;exports.simulateTx=c;exports.tenderlyRpcLinks=r;

package/API/tenderly.api.mjs

@@ -1,67 +1,56 @@
-import { chainIds as e } from "../constants/chains.constants.mjs";
-import s from "axios";
-const p = "7o1iPUgCIjLI0rSxj2yuz9-Z3052uUc4", i = "hinkal-org", d = "project", l = `https://api.tenderly.co/api/v1/account/${i}/project/${d}`, o = { "X-Access-Key": p }, m = async (t) => {
-  const { data: a } = await s.post(
-    `${l}/simulate`,
-    { ...t },
-    {
-      headers: o
-    }
-  );
-  return a;
-}, r = {
-  [e.optimism]: "https://optimism.gateway.tenderly.co/2A3r4RCMoAZVmQOpNqRO29",
-  [e.base]: "https://base.gateway.tenderly.co/73UtIBn1YiCyhqRJuKTkWl",
-  [e.ethMainnet]: "https://mainnet.gateway.tenderly.co/SW3mROrzKEQYSq3RkStJ7",
-  [e.avalanche]: "https://avalanche.gateway.tenderly.co/2YdoJTNLCUHfzwvqIUVgwZ",
-  [e.arbMainnet]: "https://arbitrum.gateway.tenderly.co/4dUF2wEnsmvFw9fqLpoLga",
-  [e.polygon]: "https://polygon.gateway.tenderly.co/32hCaUScB41nXgyzCmeDVu"
+import { chainIds as s } from "../constants/chains.constants.mjs";
+import { httpClient as a } from "../data-structures/http/HttpClient.mjs";
+import "axios";
+const c = "7o1iPUgCIjLI0rSxj2yuz9-Z3052uUc4", p = "hinkal-org", i = "project", l = `https://api.tenderly.co/api/v1/account/${p}/project/${i}`, n = { "X-Access-Key": c }, m = async (t) => await a.post(
+  `${l}/simulate`,
+  { ...t },
+  {
+    headers: n
+  }
+), r = {
+  [s.optimism]: "https://optimism.gateway.tenderly.co/2A3r4RCMoAZVmQOpNqRO29",
+  [s.base]: "https://base.gateway.tenderly.co/73UtIBn1YiCyhqRJuKTkWl",
+  [s.ethMainnet]: "https://mainnet.gateway.tenderly.co/SW3mROrzKEQYSq3RkStJ7",
+  [s.avalanche]: "https://avalanche.gateway.tenderly.co/2YdoJTNLCUHfzwvqIUVgwZ",
+  [s.arbMainnet]: "https://arbitrum.gateway.tenderly.co/4dUF2wEnsmvFw9fqLpoLga",
+  [s.polygon]: "https://polygon.gateway.tenderly.co/32hCaUScB41nXgyzCmeDVu"
   // Arc Testnet is not supported by Tenderly
-}, y = async (t, a) => {
-  const { data: n } = await s.post(
-    r[t],
-    { jsonrpc: "2.0", id: 0, method: "tenderly_simulateTransaction", params: a.params },
-    {
-      headers: o
-    }
-  );
-  return n;
-}, h = async (t, a) => {
-  const { data: n } = await s.post(
-    r[t],
-    { jsonrpc: "2.0", id: 0, method: "tenderly_simulateBundle", params: a.params },
-    { headers: o }
-  );
-  return n;
-}, u = async (t, a, n) => {
-  const { data: c } = await s.post(
-    r[t],
-    {
-      jsonrpc: "2.0",
-      id: 0,
-      method: "tenderly_getStorageChanges",
-      params: [
-        {
-          address: a,
-          offset: n
-        }
-      ]
-    },
-    {
-      headers: o
-    }
-  );
-  return c;
-}, S = {
-  rpcGetStorageChanges: u,
+}, y = async (t, e) => await a.post(
+  r[t],
+  { jsonrpc: "2.0", id: 0, method: "tenderly_simulateTransaction", params: e.params },
+  {
+    headers: n
+  }
+), d = async (t, e) => await a.post(
+  r[t],
+  { jsonrpc: "2.0", id: 0, method: "tenderly_simulateBundle", params: e.params },
+  { headers: n }
+), h = async (t, e, o) => await a.post(
+  r[t],
+  {
+    jsonrpc: "2.0",
+    id: 0,
+    method: "tenderly_getStorageChanges",
+    params: [
+      {
+        address: e,
+        offset: o
+      }
+    ]
+  },
+  {
+    headers: n
+  }
+), C = {
+  rpcGetStorageChanges: h,
   rpcSimulateTransaction: y,
-  rpcSimulateBundle: h,
+  rpcSimulateBundle: d,
   simulateTx: m
 };
 export {
-  S as WALLET_API,
-  u as rpcGetStorageChanges,
-  h as rpcSimulateBundle,
+  C as WALLET_API,
+  h as rpcGetStorageChanges,
+  d as rpcSimulateBundle,
   y as rpcSimulateTransaction,
   m as simulateTx,
   r as tenderlyRpcLinks

package/API/token-calls.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../constants/server.constants.cjs"),s=require("./getServerURL.cjs"),a=require("axios"),c=async(e,t,o=!1)=>{const{data:r}=await a.post(`${s.getServerURL(e)}${n.API_CONFIG.ROUTES.getTokensInfo}`,{tokenAddresses:t,waitForOffsetUpdate:o});return r};exports.tokensInfoCall=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("../constants/server.constants.cjs"),s=require("./getServerURL.cjs"),o=require("../data-structures/http/HttpClient.cjs");require("axios");const i=async(e,t,r=!1)=>await o.httpClient.post(`${s.getServerURL(e)}${n.API_CONFIG.ROUTES.getTokensInfo}`,{tokenAddresses:t,waitForOffsetUpdate:r});exports.tokensInfoCall=i;

package/API/token-calls.mjs

@@ -1,16 +1,14 @@
-import { API_CONFIG as a } from "../constants/server.constants.mjs";
+import { API_CONFIG as r } from "../constants/server.constants.mjs";
 import { getServerURL as n } from "./getServerURL.mjs";
-import s from "axios";
-const p = async (o, t, r = !1) => {
-  const { data: e } = await s.post(
-    `${n(o)}${a.ROUTES.getTokensInfo}`,
-    {
-      tokenAddresses: t,
-      waitForOffsetUpdate: r
-    }
-  );
-  return e;
-};
+import { httpClient as s } from "../data-structures/http/HttpClient.mjs";
+import "axios";
+const l = async (o, t, e = !1) => await s.post(
+  `${n(o)}${r.ROUTES.getTokensInfo}`,
+  {
+    tokenAddresses: t,
+    waitForOffsetUpdate: e
+  }
+);
 export {
-  p as tokensInfoCall
+  l as tokensInfoCall
 };

package/API/weeklyAnalyticCalls.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./getServerURL.cjs"),s=require("../constants/server.constants.cjs"),a=require("axios"),n=async({ethereumAddress:t})=>{const{data:e}=await a.get(`${r.DATA_SERVER_URL}${s.DATA_SERVER_CONFIG.getUserAnalytics}`,{params:{ethereumAddress:t}});return e},c=async({brotherhoodId:t,ethereumAddress:e})=>{const{data:o}=await a.get(`${r.DATA_SERVER_URL}${s.DATA_SERVER_CONFIG.getBrotherhoodAnalytics}`,{params:{brotherhoodId:t,ethereumAddress:e}});return o};exports.getBrotherhoodAnalytics=c;exports.getUserAnalytics=n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./getServerURL.cjs"),a=require("../constants/server.constants.cjs"),s=require("../data-structures/http/HttpClient.cjs");require("axios");const n=async({ethereumAddress:t})=>await s.httpClient.get(`${r.DATA_SERVER_URL}${a.DATA_SERVER_CONFIG.getUserAnalytics}`,{params:{ethereumAddress:t}}),o=async({brotherhoodId:t,ethereumAddress:e})=>await s.httpClient.get(`${r.DATA_SERVER_URL}${a.DATA_SERVER_CONFIG.getBrotherhoodAnalytics}`,{params:{brotherhoodId:t,ethereumAddress:e}});exports.getBrotherhoodAnalytics=o;exports.getUserAnalytics=n;

package/API/weeklyAnalyticCalls.mjs

@@ -1,21 +1,16 @@
 import { DATA_SERVER_URL as r } from "./getServerURL.mjs";
 import { DATA_SERVER_CONFIG as o } from "../constants/server.constants.mjs";
-import s from "axios";
-const m = async ({ ethereumAddress: t }) => {
-  const { data: a } = await s.get(`${r}${o.getUserAnalytics}`, {
-    params: { ethereumAddress: t }
-  });
-  return a;
-}, A = async ({
+import { httpClient as e } from "../data-structures/http/HttpClient.mjs";
+import "axios";
+const p = async ({ ethereumAddress: t }) => await e.get(`${r}${o.getUserAnalytics}`, {
+  params: { ethereumAddress: t }
+}), A = async ({
   brotherhoodId: t,
   ethereumAddress: a
-}) => {
-  const { data: e } = await s.get(`${r}${o.getBrotherhoodAnalytics}`, {
-    params: { brotherhoodId: t, ethereumAddress: a }
-  });
-  return e;
-};
+}) => await e.get(`${r}${o.getBrotherhoodAnalytics}`, {
+  params: { brotherhoodId: t, ethereumAddress: a }
+});
 export {
   A as getBrotherhoodAnalytics,
-  m as getUserAnalytics
+  p as getUserAnalytics
 };

package/README.md

@@ -0,0 +1,164 @@
+# Hinkal SDK
+
+Hinkal is middleware and a set of smart contracts on EVM chains that use ZK-proofs and stealth addresses to enable compliant and private transactions on major dApps. Users can privately store assets and transact on platforms such as Uniswap, Pendle, Lido, Curve, and others.
+
+This SDK enables users to perform arbitrary smart contract interactions privately.
+
+## Installation
+
+Using npm:
+
+```sh
+npm install @hinkal/common
+```
+
+Or, yarn:
+
+```sh
+yarn add @hinkal/common
+```
+
+### Usage
+
+#### Initialization
+
+To get started with Hinkal, initialize it based on the Web3 connection library you’re using:
+
+**ethers.js:**
+
+```typescript
+import { prepareEthersHinkal } from '@hinkal/common/providers/prepareEthersHinkal';
+// signer: ethers.Signer
+const hinkal = await prepareEthersHinkal(signer);
+```
+
+**wagmi:**
+
+```typescript
+import { prepareWagmiHinkal } from '@hinkal/common/providers/prepareWagmiHinkal';
+// connector: wagmi.Connector
+// config: wagmi.Config
+const hinkal = await prepareWagmiHinkal(connector, config);
+```
+
+#### Shielded balance
+
+Once the Hinkal object is initialized, shielded balances become accessible and can be calculated as needed:
+
+```typescript
+const balances = await hinkal.getBalances();
+```
+
+#### Depositing funds to the shielded balance
+
+A user can deposit funds to their shielded address using:
+
+```typescript
+function deposit(erc20addresses: string[], amountChanges: bigint[]): Promise<TransactionObject>;
+```
+
+where erc20Addresses is an array of token addresses, and amountChanges represents the token amounts for the deposit.
+
+#### Interacting with smart contracts privately
+
+After a user’s shielded balance is updated, they can perform any smart contract interaction privately using:
+
+```typescript
+function actionPrivateWallet(
+  erc20Addresses: string[],
+  amountChanges: bigint[],
+  onChainCreation: boolean[],
+  ops: string[],
+): Promise<TransactionObject>;
+```
+
+where onChainCreation indicates the amounts of tokens that are uncertain before the transaction is executed on-chain. The ops array contains encoded user operations.
+
+##### User operations
+
+To generate user operations (`ops`) you will need the `emporiumOp` function.
+```typescript
+import {emporiumOp} from "@hinkal/common";
+```
+
+The function accepts the following arguments:
+  1. `endpoint` *(required)* - target address or contract instance (with address). The contract instance will be used to properly encode the call function, if any, in the custom operation.
+  2. `func` *(optional)* - the name of the function to be called on the target address.
+  3. `args` *(optional)* - arguments of the function to be called on the target address.
+  4. `invokeWallet` *(optional)* - bool flag that determines the type of transaction. There are two types: stateful and stateless interaction. The default is false (stateless).
+  5. `value` *(optional)* - the amount of native currency to transfer to the target address.
+
+The `emporiumOp` function will generate data for subsequent calls, supporting both stateful interaction (with state preservation) and stateless interaction (without state preservation). This is determined by the `invokeWallet` flag.
+
+To execute on a smart contract, the user operation will be received in the following format:
+```solidity
+(address endpoint, bool invokeWallet, uint256 value, bytes data)
+```
+
+This will make it possible to make that kind of call:
+```solidity
+(bool success, bytes memory err) = endpoint.call{value: value}(data);
+```
+
+##### Stateless and stateful
+
+The best way to demonstrate how this works is with an example.
+
+**Stateless interaction**
+
+Let's say we need to exchange USDC for ETH using DEX. 
+
+```typescript
+const operations = [
+  emporiumOp(usdcContractInstance, 'approve', [swapRouterAddress, amountIn]),
+  emporiumOp(swapRouterContractInstance, 'exactInputSingle', [swapSingleParams]),
+  emporiumOp(wethContractInstance, 'withdraw', [amountOut]),
+];
+```
+
+To perform a DEX swap, DEX does not need to know historical data about the calling party (e.g. when and what swaps have been performed from this account in the past). It only needs the current token balance for the exchange.
+
+In this case it will be **stateless interaction**, so there is no need to change the default value of the `invokeWallet` flag.
+
+**Stateful interaction**
+
+Another example is when the protocol with which an account interacts needs to know what actions this account has done before, for example, to gain rewards. In this case, some account state will be required.
+
+Let's imagine that you already have Curve LP tokens and need to make a stake.
+
+```solidity
+const operations = [
+  emporiumOp(lpTokenInstance, 'approve', [gaugeAddressInstance, amount]), // without flag, because is's stateless interaction
+  emporiumOp(gaugeAddressInstance, 'deposit', [amount, invokeWalletAddress], true), // with flag, because it's stateful interaction
+];
+```
+
+As you can see, in this case `approve` is a stateless interaction, but `deposit` is a stateful interaction, because under the hood Curve will record this address and timestamp in order to calculate the checkpoint correctly in the future.
+
+### Access Tokens
+
+Before interacting with Hinkal smart contracts, users need to mint an access token after passing compliance checks.
+
+To check whether a user already has an access token, use the checkAccessToken function:
+
+```typescript
+function checkAccessToken(): Promise<boolean>;
+```
+
+If the user does not have an access token, they must use one of the compliance providers to pass the check. To view the available providers:
+
+```typescript
+function getSupportedPassportLinks(): string[];
+```
+
+After passing the compliance check, the user can mint an access token using:
+
+```typescript
+const { signatureData } = await hinkal.getAPI().getAccessTokenSignature(chainId, ethereumAddress, accessKey);
+await mintAccessToken(this, signatureData);
+```
+
+### References
+
+Application: [Hinkal](https://app.hinkal.pro)
+Docs: [Hinkal Documentation](https://hinkal-team.gitbook.io/hinkal)

package/_virtual/_commonjsHelpers.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var u=typeof globalThis<"u"?globalThis:typeof window<"u"?window:typeof global<"u"?global:typeof self<"u"?self:{};function f(e){return e&&e.__esModule&&Object.prototype.hasOwnProperty.call(e,"default")?e.default:e}function l(e){if(e.__esModule)return e;var r=e.default;if(typeof r=="function"){var t=function o(){return this instanceof o?Reflect.construct(r,arguments,this.constructor):r.apply(this,arguments)};t.prototype=r.prototype}else t={};return Object.defineProperty(t,"__esModule",{value:!0}),Object.keys(e).forEach(function(o){var n=Object.getOwnPropertyDescriptor(e,o);Object.defineProperty(t,o,n.get?n:{enumerable:!0,get:function(){return e[o]}})}),t}exports.commonjsGlobal=u;exports.getAugmentedNamespace=l;exports.getDefaultExportFromCjs=f;

package/_virtual/_commonjsHelpers.mjs

@@ -0,0 +1,30 @@
+var u = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
+function f(e) {
+  return e && e.__esModule && Object.prototype.hasOwnProperty.call(e, "default") ? e.default : e;
+}
+function l(e) {
+  if (e.__esModule)
+    return e;
+  var r = e.default;
+  if (typeof r == "function") {
+    var t = function o() {
+      return this instanceof o ? Reflect.construct(r, arguments, this.constructor) : r.apply(this, arguments);
+    };
+    t.prototype = r.prototype;
+  } else
+    t = {};
+  return Object.defineProperty(t, "__esModule", { value: !0 }), Object.keys(e).forEach(function(o) {
+    var n = Object.getOwnPropertyDescriptor(e, o);
+    Object.defineProperty(t, o, n.get ? n : {
+      enumerable: !0,
+      get: function() {
+        return e[o];
+      }
+    });
+  }), t;
+}
+export {
+  u as commonjsGlobal,
+  l as getAugmentedNamespace,
+  f as getDefaultExportFromCjs
+};

package/_virtual/bn.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e={exports:{}};exports.__module=e;

package/_virtual/bn.mjs

@@ -0,0 +1,4 @@
+var e = { exports: {} };
+export {
+  e as __module
+};

package/_virtual/bn2.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e={exports:{}};exports.__module=e;

package/_virtual/bn2.mjs

@@ -0,0 +1,4 @@
+var e = { exports: {} };
+export {
+  e as __module
+};

package/_virtual/common.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e={};exports.__exports=e;

package/_virtual/common.mjs

@@ -0,0 +1,4 @@
+var o = {};
+export {
+  o as __exports
+};

package/_virtual/common2.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e={};exports.__exports=e;

package/_virtual/common2.mjs

@@ -0,0 +1,4 @@
+var o = {};
+export {
+  o as __exports
+};

package/_virtual/hash.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var e={};exports.__exports=e;

package/_virtual/hash.mjs

@@ -0,0 +1,4 @@
+var a = {};
+export {
+  a as __exports
+};

package/_virtual/index.cjs

@@ -0,0 +1 @@
+"use strict";const e=require("./_commonjsHelpers.cjs"),r=require("../node_modules/@ethersproject/abi/lib.esm/index.cjs"),s=e.getAugmentedNamespace(r);module.exports=s;