@folks-finance/xchain-sdk 0.0.1

package/dist/common/types/message.d.ts

@@ -0,0 +1,239 @@
+import type { GenericAddress } from "./address.js";
+import type { FolksChainId } from "./chain.js";
+import type { AccountId, LoanId, LoanName } from "./lending.js";
+import type { LoanTypeId } from "./module.js";
+import type { FolksTokenId, FolksSpokeTokenType } from "./token.js";
+import type { FINALITY } from "../constants/message.js";
+import type { Hex } from "viem";
+export declare enum AdapterType {
+    HUB = 1,
+    WORMHOLE_DATA = 2,
+    WORMHOLE_CCTP = 3,
+    CCIP_DATA = 4,
+    CCIP_TOKEN = 5
+}
+export declare enum Action {
+    CreateAccount = 0,
+    InviteAddress = 1,
+    AcceptInviteAddress = 2,
+    UnregisterAddress = 3,
+    AddDelegate = 4,
+    RemoveDelegate = 5,
+    CreateLoan = 6,
+    DeleteLoan = 7,
+    CreateLoanAndDeposit = 8,
+    Deposit = 9,
+    DepositFToken = 10,
+    Withdraw = 11,
+    WithdrawFToken = 12,
+    Borrow = 13,
+    Repay = 14,
+    RepayWithCollateral = 15,
+    Liquidate = 16,
+    SwitchBorrowType = 17,
+    SendToken = 18
+}
+export type SendTokenAction = Extract<Action, Action.Deposit | Action.Repay>;
+export type ReceiveTokenAction = Extract<Action, Action.Withdraw | Action.Borrow>;
+export type HubAction = Extract<Action, Action.DepositFToken | Action.WithdrawFToken | Action.Liquidate | Action.SendToken>;
+export type DataAction = Extract<Action, Action.CreateAccount | Action.InviteAddress | Action.AcceptInviteAddress | Action.UnregisterAddress | Action.AddDelegate | Action.RemoveDelegate | Action.CreateLoan | Action.DeleteLoan | Action.RepayWithCollateral | Action.SwitchBorrowType>;
+export type Finality = (typeof FINALITY)[keyof typeof FINALITY];
+export type MessageAdapters = {
+    adapterId: AdapterType;
+    returnAdapterId: AdapterType;
+};
+export type SupportedMessageAdapters = {
+    adapterId: Array<AdapterType>;
+    returnAdapterId: Array<AdapterType>;
+};
+export type FeeParams = {
+    receiverValue: bigint;
+    gasLimit: bigint;
+    returnGasLimit: bigint;
+};
+export type MessageParams = FeeParams & MessageAdapters;
+export type OptionalFeeParams = Partial<FeeParams>;
+export type MessageToSend = {
+    params: MessageParams;
+    sender: GenericAddress;
+    destinationChainId: number;
+    handler: GenericAddress;
+    payload: Hex;
+    finalityLevel: Finality;
+    extraArgs: Hex;
+};
+export type DefaultMessageData = "0x";
+export type CreateAccountMessageData = {
+    refAccountId: AccountId;
+};
+export type InviteAddressMessageData = {
+    folksChainIdToInvite: FolksChainId;
+    addressToInvite: GenericAddress;
+    refAccountId: AccountId;
+};
+export type UnregisterAddressMessageData = {
+    folksChainIdToUnregister: FolksChainId;
+};
+export type CreateLoanMessageData = {
+    loanId: LoanId;
+    loanTypeId: LoanTypeId;
+    loanName: LoanName;
+};
+export type DeleteLoanMessageData = {
+    accountId: AccountId;
+    loanId: LoanId;
+};
+export type CreateLoanAndDepositMessageData = {
+    loanId: LoanId;
+    poolId: number;
+    amount: bigint;
+    loanTypeId: LoanTypeId;
+    loanName: LoanName;
+};
+export type DepositMessageData = {
+    loanId: LoanId;
+    poolId: number;
+    amount: bigint;
+};
+export type WithdrawMessageData = {
+    loanId: LoanId;
+    poolId: number;
+    receiverFolksChainId: FolksChainId;
+    amount: bigint;
+    isFAmount: boolean;
+};
+export type BorrowMessageData = {
+    loanId: LoanId;
+    poolId: number;
+    receiverFolksChainId: FolksChainId;
+    amount: bigint;
+    maxStableRate: bigint;
+};
+export type RepayMessageData = {
+    loanId: LoanId;
+    poolId: number;
+    amount: bigint;
+    maxOverRepayment: bigint;
+};
+export type RepayWithCollateralMessageData = {
+    loanId: LoanId;
+    poolId: number;
+    amount: bigint;
+};
+export type SwitchBorrowTypeMessageData = {
+    loanId: LoanId;
+    poolId: number;
+    maxStableRate: bigint;
+};
+export type LiquidateMessageData = {
+    violatorLoanId: LoanId;
+    liquidatorLoanId: LoanId;
+    colPoolId: number;
+    borPoolId: number;
+    repayingAmount: bigint;
+    minSeizedAmount: bigint;
+};
+export type SendTokenMessageData = {
+    folksTokenId: FolksTokenId;
+    amount: bigint;
+};
+export type DefaultExtraArgs = "0x";
+export type DepositExtraArgs = {
+    token: FolksSpokeTokenType;
+    recipient: GenericAddress;
+    amount: bigint;
+};
+export type RepayExtraArgs = {
+    token: FolksSpokeTokenType;
+    recipient: GenericAddress;
+    amount: bigint;
+};
+export type SendTokenExtraArgs = {
+    token: FolksSpokeTokenType;
+    recipient: GenericAddress;
+    amount: bigint;
+};
+export type DefaultMessageDataParams = {
+    action: Action.AcceptInviteAddress | Action.AddDelegate | Action.RemoveDelegate | Action.DepositFToken | Action.WithdrawFToken;
+    data: DefaultMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type CreateAccountMessageDataParams = {
+    action: Action.CreateAccount;
+    data: CreateAccountMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type InviteAddressMessageDataParams = {
+    action: Action.InviteAddress;
+    data: InviteAddressMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type UnregisterAddressMessageDataParams = {
+    action: Action.UnregisterAddress;
+    data: UnregisterAddressMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type CreateLoanMessageDataParams = {
+    action: Action.CreateLoan;
+    data: CreateLoanMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type DeleteLoanMessageDataParams = {
+    action: Action.DeleteLoan;
+    data: DeleteLoanMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type CreateLoanAndDepositMessageDataParams = {
+    action: Action.CreateLoanAndDeposit;
+    data: CreateLoanAndDepositMessageData;
+    extraArgs: DepositExtraArgs;
+};
+export type DepositMessageDataParams = {
+    action: Action.Deposit;
+    data: DepositMessageData;
+    extraArgs: DepositExtraArgs;
+};
+export type WithdrawMessageDataParams = {
+    action: Action.Withdraw;
+    data: WithdrawMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type BorrowMessageDataParams = {
+    action: Action.Borrow;
+    data: BorrowMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type RepayMessageDataParams = {
+    action: Action.Repay;
+    data: RepayMessageData;
+    extraArgs: RepayExtraArgs;
+};
+export type RepayWithCollateralMessageDataParams = {
+    action: Action.RepayWithCollateral;
+    data: RepayWithCollateralMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type SwitchBorrowTypeMessageDataParams = {
+    action: Action.SwitchBorrowType;
+    data: SwitchBorrowTypeMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type LiquidateMessageDataParams = {
+    action: Action.Liquidate;
+    data: LiquidateMessageData;
+    extraArgs: DefaultExtraArgs;
+};
+export type SendTokenMessageDataParams = {
+    action: Action.SendToken;
+    data: SendTokenMessageData;
+    extraArgs: SendTokenExtraArgs;
+};
+export type MessageDataParams = DefaultMessageDataParams | CreateAccountMessageDataParams | InviteAddressMessageDataParams | UnregisterAddressMessageDataParams | CreateLoanMessageDataParams | DeleteLoanMessageDataParams | CreateLoanAndDepositMessageDataParams | DepositMessageDataParams | WithdrawMessageDataParams | BorrowMessageDataParams | RepayMessageDataParams | RepayWithCollateralMessageDataParams | SwitchBorrowTypeMessageDataParams | LiquidateMessageDataParams | SendTokenMessageDataParams;
+export type MessageBuilderParams = {
+    userAddress: GenericAddress;
+    accountId: AccountId;
+    adapters: MessageAdapters;
+    sender: GenericAddress;
+    destinationChainId: FolksChainId;
+    handler: GenericAddress;
+} & MessageDataParams;

package/dist/common/types/message.js

@@ -0,0 +1,33 @@
+export var AdapterType;
+(function (AdapterType) {
+    AdapterType[AdapterType["HUB"] = 1] = "HUB";
+    AdapterType[AdapterType["WORMHOLE_DATA"] = 2] = "WORMHOLE_DATA";
+    AdapterType[AdapterType["WORMHOLE_CCTP"] = 3] = "WORMHOLE_CCTP";
+    AdapterType[AdapterType["CCIP_DATA"] = 4] = "CCIP_DATA";
+    AdapterType[AdapterType["CCIP_TOKEN"] = 5] = "CCIP_TOKEN";
+})(AdapterType || (AdapterType = {}));
+export var Action;
+(function (Action) {
+    // SPOKE -> HUB
+    Action[Action["CreateAccount"] = 0] = "CreateAccount";
+    Action[Action["InviteAddress"] = 1] = "InviteAddress";
+    Action[Action["AcceptInviteAddress"] = 2] = "AcceptInviteAddress";
+    Action[Action["UnregisterAddress"] = 3] = "UnregisterAddress";
+    Action[Action["AddDelegate"] = 4] = "AddDelegate";
+    Action[Action["RemoveDelegate"] = 5] = "RemoveDelegate";
+    Action[Action["CreateLoan"] = 6] = "CreateLoan";
+    Action[Action["DeleteLoan"] = 7] = "DeleteLoan";
+    Action[Action["CreateLoanAndDeposit"] = 8] = "CreateLoanAndDeposit";
+    Action[Action["Deposit"] = 9] = "Deposit";
+    Action[Action["DepositFToken"] = 10] = "DepositFToken";
+    Action[Action["Withdraw"] = 11] = "Withdraw";
+    Action[Action["WithdrawFToken"] = 12] = "WithdrawFToken";
+    Action[Action["Borrow"] = 13] = "Borrow";
+    Action[Action["Repay"] = 14] = "Repay";
+    Action[Action["RepayWithCollateral"] = 15] = "RepayWithCollateral";
+    Action[Action["Liquidate"] = 16] = "Liquidate";
+    Action[Action["SwitchBorrowType"] = 17] = "SwitchBorrowType";
+    // HUB -> SPOKE
+    Action[Action["SendToken"] = 18] = "SendToken";
+})(Action || (Action = {}));
+//# sourceMappingURL=message.js.map

package/dist/common/types/message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/common/types/message.ts"],"names":[],"mappings":"AAQA,MAAM,CAAN,IAAY,WAMX;AAND,WAAY,WAAW;IACrB,2CAAO,CAAA;IACP,+DAAiB,CAAA;IACjB,+DAAiB,CAAA;IACjB,uDAAa,CAAA;IACb,yDAAc,CAAA;AAChB,CAAC,EANW,WAAW,KAAX,WAAW,QAMtB;AAED,MAAM,CAAN,IAAY,MAsBX;AAtBD,WAAY,MAAM;IAChB,eAAe;IACf,qDAAa,CAAA;IACb,qDAAa,CAAA;IACb,iEAAmB,CAAA;IACnB,6DAAiB,CAAA;IACjB,iDAAW,CAAA;IACX,uDAAc,CAAA;IACd,+CAAU,CAAA;IACV,+CAAU,CAAA;IACV,mEAAoB,CAAA;IACpB,yCAAO,CAAA;IACP,sDAAa,CAAA;IACb,4CAAQ,CAAA;IACR,wDAAc,CAAA;IACd,wCAAM,CAAA;IACN,sCAAK,CAAA;IACL,kEAAmB,CAAA;IACnB,8CAAS,CAAA;IACT,4DAAgB,CAAA;IAChB,eAAe;IACf,8CAAS,CAAA;AACX,CAAC,EAtBW,MAAM,KAAN,MAAM,QAsBjB"}

package/dist/common/types/module.d.ts

@@ -0,0 +1,21 @@
+import type { PrepareCreateAccountCall as PrepareCreateAccountEVMCall, PrepareInviteAddressCall as PrepareInviteAddressEVMCall, PrepareAcceptInviteAddressCall as PrepareAcceptInviteAddressEVMCall, PrepareUnregisterAddressCall as PrepareUnregisterAddressEVMCall, PrepareCreateLoanCall as PrepareCreateLoanEVMCall, PrepareDeleteLoanCall as PrepareDeleteLoanEVMCall, PrepareCreateLoanAndDepositCall as PrepareCreateLoanAndDepositEVMCall, PrepareDepositCall as PrepareDepositEVMCall, PrepareWithdrawCall as PrepareWithdrawEVMCall, PrepareCall as PrepareEVMCall, PrepareBorrowCall as PrepareBorrowEVMCall, PrepareRepayCall as PrepareRepayEVMCall, PrepareRepayWithCollateralCall as PrepareRepayWithCollateralEVMCall, PrepareSwitchBorrowTypeCall as PrepareSwitchBorrowTypeEVMCall, PrepareLiquidateCall as PrepareLiquidateEVMCall, PrepareRetryMessageCall as PrepareRetryMessageEVMCall } from "../../chains/evm/common/types/module.js";
+export declare enum LoanTypeId {
+    DEPOSIT = 1,// no support for borrows
+    GENERAL = 2
+}
+export type PrepareCall = PrepareEVMCall;
+export type PrepareCreateAccountCall = PrepareCreateAccountEVMCall;
+export type PrepareInviteAddressCall = PrepareInviteAddressEVMCall;
+export type PrepareAcceptInviteAddressCall = PrepareAcceptInviteAddressEVMCall;
+export type PrepareUnregisterAddressCall = PrepareUnregisterAddressEVMCall;
+export type PrepareCreateLoanCall = PrepareCreateLoanEVMCall;
+export type PrepareDeleteLoanCall = PrepareDeleteLoanEVMCall;
+export type PrepareCreateLoanAndDepositCall = PrepareCreateLoanAndDepositEVMCall;
+export type PrepareDepositCall = PrepareDepositEVMCall;
+export type PrepareWithdrawCall = PrepareWithdrawEVMCall;
+export type PrepareBorrowCall = PrepareBorrowEVMCall;
+export type PrepareRepayCall = PrepareRepayEVMCall;
+export type PrepareRepayWithCollateralCall = PrepareRepayWithCollateralEVMCall;
+export type PrepareSwitchBorrowTypeCall = PrepareSwitchBorrowTypeEVMCall;
+export type PrepareLiquidateCall = PrepareLiquidateEVMCall;
+export type PrepareRetryMessageCall = PrepareRetryMessageEVMCall;

package/dist/common/types/module.js

@@ -0,0 +1,6 @@
+export var LoanTypeId;
+(function (LoanTypeId) {
+    LoanTypeId[LoanTypeId["DEPOSIT"] = 1] = "DEPOSIT";
+    LoanTypeId[LoanTypeId["GENERAL"] = 2] = "GENERAL";
+})(LoanTypeId || (LoanTypeId = {}));
+//# sourceMappingURL=module.js.map

package/dist/common/types/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/common/types/module.ts"],"names":[],"mappings":"AAmBA,MAAM,CAAN,IAAY,UAGX;AAHD,WAAY,UAAU;IACpB,iDAAW,CAAA;IACX,iDAAW,CAAA;AACb,CAAC,EAHW,UAAU,KAAV,UAAU,QAGrB"}

package/dist/common/types/token.d.ts

@@ -0,0 +1,42 @@
+import type { GenericAddress } from "./address.js";
+export declare enum FolksTokenId {
+    USDC = "USDC",
+    AVAX = "AVAX",
+    ETH_eth_sep = "ETH_eth_sep",
+    ETH_base_sep = "ETH_base_sep",
+    LINK_eth_sep = "LINK_eth_sep"
+}
+export declare enum TokenType {
+    NATIVE = "NATIVE",
+    ERC20 = "ERC20",
+    CIRCLE = "CIRCLE"
+}
+export type ITokenData = {
+    folksTokenId: FolksTokenId;
+};
+type Erc20SpokeTokenType = {
+    type: TokenType.ERC20;
+    address: GenericAddress;
+    decimals: number;
+};
+type Erc20HubTokenType = {
+    type: TokenType.ERC20;
+    decimals: number;
+};
+type CircleTokenType = {
+    type: TokenType.CIRCLE;
+    address: GenericAddress;
+    decimals: number;
+};
+type NativeTokenType = {
+    type: TokenType.NATIVE;
+    decimals: number;
+};
+export type FolksSpokeTokenType = Erc20SpokeTokenType | CircleTokenType | NativeTokenType;
+export type FolksHubTokenType = Erc20HubTokenType | CircleTokenType | NativeTokenType;
+export type SpokeTokenData = {
+    poolId: number;
+    spokeAddress: GenericAddress;
+    token: FolksSpokeTokenType;
+} & ITokenData;
+export {};

package/dist/common/types/token.js

@@ -0,0 +1,15 @@
+export var FolksTokenId;
+(function (FolksTokenId) {
+    FolksTokenId["USDC"] = "USDC";
+    FolksTokenId["AVAX"] = "AVAX";
+    FolksTokenId["ETH_eth_sep"] = "ETH_eth_sep";
+    FolksTokenId["ETH_base_sep"] = "ETH_base_sep";
+    FolksTokenId["LINK_eth_sep"] = "LINK_eth_sep";
+})(FolksTokenId || (FolksTokenId = {}));
+export var TokenType;
+(function (TokenType) {
+    TokenType["NATIVE"] = "NATIVE";
+    TokenType["ERC20"] = "ERC20";
+    TokenType["CIRCLE"] = "CIRCLE";
+})(TokenType || (TokenType = {}));
+//# sourceMappingURL=token.js.map

package/dist/common/types/token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../../src/common/types/token.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,6BAAa,CAAA;IACb,6BAAa,CAAA;IACb,2CAA2B,CAAA;IAC3B,6CAA6B,CAAA;IAC7B,6CAA6B,CAAA;AAC/B,CAAC,EANW,YAAY,KAAZ,YAAY,QAMvB;AAED,MAAM,CAAN,IAAY,SAIX;AAJD,WAAY,SAAS;IACnB,8BAAiB,CAAA;IACjB,4BAAe,CAAA;IACf,8BAAiB,CAAA;AACnB,CAAC,EAJW,SAAS,KAAT,SAAS,QAIpB"}

package/dist/common/utils/adapter.d.ts

@@ -0,0 +1,11 @@
+import { AdapterType } from "../types/message.js";
+import type { MessageAdapterParams } from "../types/adapter.js";
+import type { FolksChainId } from "../types/chain.js";
+export declare function doesAdapterSupportDataMessage(folksChainId: FolksChainId, adapterId: AdapterType): boolean;
+export declare function assertAdapterSupportsDataMessage(folksChainId: FolksChainId, adapterId: AdapterType): void;
+export declare function doesAdapterSupportTokenMessage(folksChainId: FolksChainId, adapterId: AdapterType): boolean;
+export declare function assertAdapterSupportsTokenMessage(folksChainId: FolksChainId, adapterId: AdapterType): void;
+export declare function getSupportedMessageAdapters(params: MessageAdapterParams): {
+    adapterIds: AdapterType[];
+    returnAdapterIds: AdapterType[];
+};

package/dist/common/utils/adapter.js

@@ -0,0 +1,63 @@
+import { isHubChain } from "../../chains/evm/hub/utils/chain.js";
+import { exhaustiveCheck } from "../../utils/exhaustive-check.js";
+import { FolksCore } from "../../xchain/core/folks-core.js";
+import { DATA_ADAPTERS, HUB_ADAPTERS, TOKEN_ADAPTERS } from "../constants/adapter.js";
+import { MessageAdapterParamsType } from "../types/adapter.js";
+import { AdapterType } from "../types/message.js";
+import { isCircleToken } from "./token.js";
+export function doesAdapterSupportDataMessage(folksChainId, adapterId) {
+    const isHub = isHubChain(folksChainId, FolksCore.getSelectedNetwork());
+    return ((isHub && adapterId === AdapterType.HUB) ||
+        (!isHub && (adapterId === AdapterType.WORMHOLE_DATA || adapterId === AdapterType.CCIP_DATA)));
+}
+export function assertAdapterSupportsDataMessage(folksChainId, adapterId) {
+    if (!doesAdapterSupportDataMessage(folksChainId, adapterId))
+        throw Error(`Adapter ${adapterId} does not support data message for folksChainId: ${folksChainId}`);
+}
+export function doesAdapterSupportTokenMessage(folksChainId, adapterId) {
+    const isHub = isHubChain(folksChainId, FolksCore.getSelectedNetwork());
+    return ((isHub && adapterId === AdapterType.HUB) ||
+        (!isHub && (adapterId === AdapterType.WORMHOLE_CCTP || adapterId === AdapterType.CCIP_TOKEN)));
+}
+export function assertAdapterSupportsTokenMessage(folksChainId, adapterId) {
+    if (!doesAdapterSupportTokenMessage(folksChainId, adapterId))
+        throw Error(`Adapter ${adapterId} does not support token message for folksChainId: ${folksChainId}`);
+}
+function getAdapterIds(messageAdapterParams) {
+    const { sourceFolksChainId, network, messageAdapterParamType } = messageAdapterParams;
+    if (isHubChain(sourceFolksChainId, network))
+        return HUB_ADAPTERS;
+    if (messageAdapterParamType == MessageAdapterParamsType.SendToken && isCircleToken(messageAdapterParams.folksTokenId))
+        return TOKEN_ADAPTERS;
+    return DATA_ADAPTERS;
+}
+function getReturnAdapterIds({ folksTokenId, destFolksChainId, network }) {
+    if (isHubChain(destFolksChainId, network))
+        return HUB_ADAPTERS;
+    if (isCircleToken(folksTokenId))
+        return TOKEN_ADAPTERS;
+    return DATA_ADAPTERS;
+}
+export function getSupportedMessageAdapters(params) {
+    const { messageAdapterParamType } = params;
+    switch (messageAdapterParamType) {
+        case MessageAdapterParamsType.SendToken:
+            return {
+                adapterIds: getAdapterIds(params),
+                returnAdapterIds: [AdapterType.HUB],
+            };
+        case MessageAdapterParamsType.ReceiveToken:
+            return {
+                adapterIds: getAdapterIds(params),
+                returnAdapterIds: getReturnAdapterIds(params),
+            };
+        case MessageAdapterParamsType.Data:
+            return {
+                adapterIds: getAdapterIds(params),
+                returnAdapterIds: [AdapterType.HUB],
+            };
+        default:
+            return exhaustiveCheck(messageAdapterParamType);
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/common/utils/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../src/common/utils/adapter.ts"],"names":[],"mappings":"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"}

package/dist/common/utils/address.d.ts

@@ -0,0 +1,8 @@
+import { ChainType } from "../types/chain.js";
+import type { AddressType, GenericAddress } from "../types/address.js";
+import type { AccountId } from "../types/lending.js";
+export declare function getRandomGenericAddress(): GenericAddress;
+export declare function isGenericAddress(address: GenericAddress): boolean;
+export declare function isAccountId(accountId: AccountId): boolean;
+export declare function convertToGenericAddress<T extends ChainType>(address: AddressType<T>, fromChainType: ChainType): GenericAddress;
+export declare function convertFromGenericAddress<T extends ChainType>(address: GenericAddress, toChainType: ChainType): AddressType<T>;

package/dist/common/utils/address.js

@@ -0,0 +1,35 @@
+import { getAddress, pad, sliceHex } from "viem";
+import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
+import { exhaustiveCheck } from "../../utils/exhaustive-check.js";
+import { BYTES32_LENGTH, EVM_ADDRESS_BYTES_LENGTH } from "../constants/bytes.js";
+import { ChainType } from "../types/chain.js";
+export function getRandomGenericAddress() {
+    return pad(privateKeyToAccount(generatePrivateKey()).address, {
+        size: BYTES32_LENGTH,
+    }).toLowerCase();
+}
+export function isGenericAddress(address) {
+    return address.length === 64 + 2;
+}
+export function isAccountId(accountId) {
+    return accountId.length === 64 + 2;
+}
+export function convertToGenericAddress(address, fromChainType) {
+    switch (fromChainType) {
+        case ChainType.EVM:
+            return pad(address, {
+                size: BYTES32_LENGTH,
+            }).toLowerCase();
+        default:
+            return exhaustiveCheck(fromChainType);
+    }
+}
+export function convertFromGenericAddress(address, toChainType) {
+    switch (toChainType) {
+        case ChainType.EVM:
+            return getAddress(sliceHex(address, BYTES32_LENGTH - EVM_ADDRESS_BYTES_LENGTH));
+        default:
+            return exhaustiveCheck(toChainType);
+    }
+}
+//# sourceMappingURL=address.js.map

package/dist/common/utils/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/common/utils/address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAExE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,MAAM,UAAU,uBAAuB;IACrC,OAAO,GAAG,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE;QAC5D,IAAI,EAAE,cAAc;KACrB,CAAC,CAAC,WAAW,EAAoB,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAuB;IACtD,OAAO,OAAO,CAAC,MAAM,KAAK,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,SAAoB;IAC9C,OAAO,SAAS,CAAC,MAAM,KAAK,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAuB,EACvB,aAAwB;IAExB,QAAQ,aAAa,EAAE,CAAC;QACtB,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,GAAG,CAAC,OAAqB,EAAE;gBAChC,IAAI,EAAE,cAAc;aACrB,CAAC,CAAC,WAAW,EAAoB,CAAC;QACrC;YACE,OAAO,eAAe,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,OAAuB,EACvB,WAAsB;IAEtB,QAAQ,WAAW,EAAE,CAAC;QACpB,KAAK,SAAS,CAAC,GAAG;YAChB,OAAO,UAAU,CAAC,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,wBAAwB,CAAC,CAAe,CAAC;QAChG;YACE,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/common/utils/bytes.d.ts

@@ -0,0 +1,9 @@
+import type { AccountId, LoanId } from "../types/lending.js";
+import type { Hex } from "viem";
+export declare function getEmptyBytes(length: number): string;
+export declare function getAccountIdBytes(accountId: string): AccountId;
+export declare function convertNumberToBytes(num: number | bigint, length: number): Hex;
+export declare function convertStringToBytes(str: string): Hex;
+export declare function convertBooleanToByte(bool: boolean): Hex;
+export declare function getRandomBytes(length: number): Hex;
+export declare function generateLoanId(): LoanId;

package/dist/common/utils/bytes.js

@@ -0,0 +1,34 @@
+import { bytesToHex, pad, toHex } from "viem";
+import { BYTES32_LENGTH } from "../constants/bytes.js";
+export function getEmptyBytes(length) {
+    return pad("0x", { size: length });
+}
+export function getAccountIdBytes(accountId) {
+    return pad(toHex(Buffer.from(accountId)), {
+        size: BYTES32_LENGTH,
+    });
+}
+export function convertNumberToBytes(num, length) {
+    // insert 0s at the beginning if data is smaller than length bytes
+    const buf = Buffer.alloc(length, 0);
+    // convert num to bytes
+    const hex = num.toString(16);
+    const isEven = hex.length % 2 === 0;
+    const bytes = Buffer.from(isEven ? hex : "0" + hex, "hex");
+    // write bytes to fixed length buf
+    bytes.copy(buf, buf.length - bytes.length);
+    return toHex(buf);
+}
+export function convertStringToBytes(str) {
+    return toHex("0x" + Buffer.from(str).toString("hex"));
+}
+export function convertBooleanToByte(bool) {
+    return bool ? "0x01" : "0x00";
+}
+export function getRandomBytes(length) {
+    return bytesToHex(crypto.getRandomValues(new Uint8Array(length)));
+}
+export function generateLoanId() {
+    return getRandomBytes(BYTES32_LENGTH);
+}
+//# sourceMappingURL=bytes.js.map

package/dist/common/utils/bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../../src/common/utils/bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAKvD,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,OAAO,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IACjD,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE;QACxC,IAAI,EAAE,cAAc;KACrB,CAAc,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAoB,EAAE,MAAc;IACvE,kEAAkE;IAClE,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEpC,uBAAuB;IACvB,MAAM,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;IAE3D,kCAAkC;IAClC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,OAAO,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC,cAAc,CAAW,CAAC;AAClD,CAAC"}

package/dist/common/utils/chain.d.ts

@@ -0,0 +1,19 @@
+import type { GenericAddress } from "../types/address.js";
+import type { FolksChain, FolksChainId, NetworkType, SpokeChain } from "../types/chain.js";
+import type { FolksChainSigner } from "../types/core.js";
+import type { AdapterType } from "../types/message.js";
+import type { FolksTokenId, SpokeTokenData } from "../types/token.js";
+export declare function getFolksChain(folksChainId: FolksChainId, network: NetworkType): FolksChain;
+export declare function getFolksChainsByNetwork(network: NetworkType): Array<FolksChain>;
+export declare function getFolksChainIdsByNetwork(networkType: NetworkType): Array<FolksChainId>;
+export declare function isSpokeChainSupported(folksChainId: FolksChainId, network: NetworkType): boolean;
+export declare function assertSpokeChainSupported(folksChainId: FolksChainId, network: NetworkType): void;
+export declare function getSpokeChain(folksChainId: FolksChainId, network: NetworkType): SpokeChain;
+export declare function doesSpokeSupportFolksToken(spokeChain: SpokeChain, folksTokenId: FolksTokenId): boolean;
+export declare function getSpokeTokenData(spokeChain: SpokeChain, folksTokenId: FolksTokenId): SpokeTokenData;
+export declare function isFolksTokenSupported(folksTokenId: FolksTokenId, folksChainId: FolksChainId, network: NetworkType): boolean;
+export declare function assertSpokeChainSupportFolksToken(folksChainId: FolksChainId, folksTokenId: FolksTokenId, network: NetworkType): void;
+export declare function getSpokeChainAdapterAddress(folksChainId: FolksChainId, network: NetworkType, adapterType: AdapterType): GenericAddress;
+export declare function getAdapterAddress(folksChainId: FolksChainId, network: NetworkType, adapterType: AdapterType): GenericAddress;
+export declare function getSignerGenericAddress(folksChainSigner: FolksChainSigner): GenericAddress;
+export declare function assertHubChainSelected(folksChainId: FolksChainId, network: NetworkType): void;

package/dist/common/utils/chain.js

@@ -0,0 +1,74 @@
+import { getEvmSignerAddress } from "../../chains/evm/common/utils/chain.js";
+import { getHubChainAdapterAddress, isHubChain } from "../../chains/evm/hub/utils/chain.js";
+import { exhaustiveCheck } from "../../utils/exhaustive-check.js";
+import { FOLKS_CHAIN, SPOKE_CHAIN } from "../constants/chain.js";
+import { ChainType } from "../types/chain.js";
+import { convertToGenericAddress } from "./address.js";
+export function getFolksChain(folksChainId, network) {
+    const folksChain = FOLKS_CHAIN[network][folksChainId];
+    if (!folksChain)
+        throw new Error(`Folks Chain not found for folksChainId: ${folksChainId}`);
+    return folksChain;
+}
+export function getFolksChainsByNetwork(network) {
+    return Object.values(FOLKS_CHAIN[network]);
+}
+export function getFolksChainIdsByNetwork(networkType) {
+    return getFolksChainsByNetwork(networkType).map((folksChain) => folksChain.folksChainId);
+}
+export function isSpokeChainSupported(folksChainId, network) {
+    return SPOKE_CHAIN[network][folksChainId] !== undefined;
+}
+export function assertSpokeChainSupported(folksChainId, network) {
+    if (!isSpokeChainSupported(folksChainId, network))
+        throw new Error(`Spoke chain is not supported for folksChainId: ${folksChainId}`);
+}
+export function getSpokeChain(folksChainId, network) {
+    const spokeChain = SPOKE_CHAIN[network][folksChainId];
+    if (!spokeChain)
+        throw new Error(`Spoke chain not found for folksChainId: ${folksChainId}`);
+    return spokeChain;
+}
+export function doesSpokeSupportFolksToken(spokeChain, folksTokenId) {
+    return spokeChain.tokens[folksTokenId] !== undefined;
+}
+export function getSpokeTokenData(spokeChain, folksTokenId) {
+    const tokenData = spokeChain.tokens[folksTokenId];
+    if (!tokenData)
+        throw new Error(`Spoke Token not found for folksTokenId: ${folksTokenId}`);
+    return tokenData;
+}
+export function isFolksTokenSupported(folksTokenId, folksChainId, network) {
+    const spokeChain = getSpokeChain(folksChainId, network);
+    return doesSpokeSupportFolksToken(spokeChain, folksTokenId);
+}
+export function assertSpokeChainSupportFolksToken(folksChainId, folksTokenId, network) {
+    if (!isFolksTokenSupported(folksTokenId, folksChainId, network))
+        throw new Error(`Folks Token ${folksTokenId} is not supported on Folks Chain ${folksChainId}`);
+}
+export function getSpokeChainAdapterAddress(folksChainId, network, adapterType) {
+    const spokeChain = getSpokeChain(folksChainId, network);
+    const adapterAddress = spokeChain.adapters[adapterType];
+    if (adapterAddress)
+        return adapterAddress;
+    throw new Error(`Adapter ${adapterType} not found for spoke chain ${folksChainId}`);
+}
+export function getAdapterAddress(folksChainId, network, adapterType) {
+    if (isHubChain(folksChainId, network))
+        return getHubChainAdapterAddress(network, adapterType);
+    return getSpokeChainAdapterAddress(folksChainId, network, adapterType);
+}
+export function getSignerGenericAddress(folksChainSigner) {
+    const chainType = folksChainSigner.chainType;
+    switch (chainType) {
+        case ChainType.EVM:
+            return convertToGenericAddress(getEvmSignerAddress(folksChainSigner.signer), chainType);
+        default:
+            return exhaustiveCheck(chainType);
+    }
+}
+export function assertHubChainSelected(folksChainId, network) {
+    if (!isHubChain(folksChainId, network))
+        throw new Error(`Wrong chain selected: ${folksChainId}. Expected Hub chain`);
+}
+//# sourceMappingURL=chain.js.map