@peeramid-labs/sdk 1.0.0

package/lib.esm/multipass/MultipassBase.d.ts

@@ -0,0 +1,120 @@
+import { type Address, type Hex } from "viem";
+import type { RegisterMessage } from "../types";
+/**
+ * Structure representing a name query for Multipass
+ * @public
+ */
+export type NameQuery = {
+    /** Hex-encoded name */
+    name: Hex;
+    /** Hex-encoded ID */
+    id: Hex;
+    /** Wallet address */
+    wallet: Address;
+    /** Hex-encoded domain name */
+    domainName: Hex;
+    /** Hex-encoded target domain */
+    targetDomain: Hex;
+};
+/**
+ * Base class for Multipass functionality
+ */
+export default class MultipassBase {
+    /** Chain ID for the network */
+    chainId: number;
+    /**
+     * Creates a new MultipassBase instance
+     * @param params - Constructor parameters
+     * @param params.chainId - ID of the blockchain network
+     */
+    constructor({ chainId }: {
+        chainId: number;
+    });
+    /**
+     * Generates a URL for a dapp
+     * @param message - Message object to be encoded in the URL
+     * @param signature - Signature to be encoded in the URL
+     * @param basepath - Base path of the URL
+     * @param contractAddress - Address of the contract
+     * @returns The generated URL
+     */
+    getDappURL(message: object, signature: string, basepath: string, contractAddress: string): string;
+    getRegistrarMessage: ({ username, id, domainName, validUntil, }: {
+        username: string;
+        id: string;
+        domainName: string;
+        validUntil: number;
+    }) => RegisterMessage;
+    /**
+     * Creates a name query by address
+     * @param params - Parameters for creating the query
+     * @param params.address - Address to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByAddress: ({ address, domainName, targetDomain, }: {
+        address: string;
+        domainName: string;
+        targetDomain?: string;
+    }) => NameQuery;
+    /**
+     * Creates a name query by ID
+     * @param params - Parameters for creating the query
+     * @param params.id - ID to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryById: ({ id, domainName, targetDomain, }: {
+        id: string;
+        domainName: string;
+        targetDomain?: string;
+    }) => NameQuery;
+    /**
+     * Creates a name query by username
+     * @param params - Parameters for creating the query
+     * @param params.username - Username to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByUsername: ({ username, domainName, targetDomain, }: {
+        username: string;
+        domainName: string;
+        targetDomain?: string;
+    }) => NameQuery;
+    /**
+     * Creates a name query by username and ID
+     * @param params - Parameters for creating the query
+     * @param params.username - Username to be encoded in the query
+     * @param params.id - ID to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByUsernameAndId: ({ username, id, domainName, targetDomain, }: {
+        username: string;
+        id: string;
+        domainName: string;
+        targetDomain?: string;
+    }) => NameQuery;
+    /**
+     * Creates a name query with full details
+     * @param params - Parameters for creating the query
+     * @param params.username - Username to be encoded in the query
+     * @param params.id - ID to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @param params.address - Address to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByFullDetails: ({ username, id, domainName, targetDomain, address, }: {
+        username: string;
+        id: string;
+        domainName: string;
+        targetDomain?: string;
+        address: string;
+    }) => NameQuery;
+}
+//# sourceMappingURL=MultipassBase.d.ts.map

package/lib.esm/multipass/MultipassBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultipassBase.d.ts","sourceRoot":"","sources":["../../../src/multipass/MultipassBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,GAAG,EAAuC,MAAM,MAAM,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,uBAAuB;IACvB,IAAI,EAAE,GAAG,CAAC;IACV,qBAAqB;IACrB,EAAE,EAAE,GAAG,CAAC;IACR,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,UAAU,EAAE,GAAG,CAAC;IAChB,gCAAgC;IAChC,YAAY,EAAE,GAAG,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,aAAa;IAChC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;gBACS,EAAE,OAAO,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;IAI5C;;;;;;;OAOG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM;IAcxF,mBAAmB,8CAKvB;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,KAAG,eAAe,CAQjB;IAEF;;;;;;;OAOG;IACI,kBAAkB,2CAItB;QACD,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KAAG,SAAS,CASX;IAEF;;;;;;;OAOG;IACI,aAAa,sCAIjB;QACD,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KAAG,SAAS,CAQX;IAEF;;;;;;;OAOG;IACI,mBAAmB,4CAIvB;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KAAG,SAAS,CAQX;IAEF;;;;;;;;OAQG;IACI,wBAAwB,gDAK5B;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,KAAG,SAAS,CAQX;IAEF;;;;;;;;;OASG;IACI,sBAAsB,yDAM1B;QACD,QAAQ,EAAE,MAAM,CAAC;QACjB,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;KACjB,KAAG,SAAS,CASX;CACH"}

package/lib.esm/multipass/MultipassBase.js

@@ -0,0 +1,137 @@
+import { stringToHex, zeroAddress, isAddress } from "viem";
+/**
+ * Base class for Multipass functionality
+ */
+export default class MultipassBase {
+    /** Chain ID for the network */
+    chainId;
+    /**
+     * Creates a new MultipassBase instance
+     * @param params - Constructor parameters
+     * @param params.chainId - ID of the blockchain network
+     */
+    constructor({ chainId }) {
+        this.chainId = chainId;
+    }
+    /**
+     * Generates a URL for a dapp
+     * @param message - Message object to be encoded in the URL
+     * @param signature - Signature to be encoded in the URL
+     * @param basepath - Base path of the URL
+     * @param contractAddress - Address of the contract
+     * @returns The generated URL
+     */
+    getDappURL(message, signature, basepath, contractAddress) {
+        return (basepath +
+            "/?message=" +
+            Buffer.from(JSON.stringify(message)).toString("base64") +
+            "&contractAddress=" +
+            contractAddress +
+            "&signature=" +
+            signature +
+            "&chainId=" +
+            this.chainId);
+    }
+    getRegistrarMessage = ({ username, id, domainName, validUntil, }) => {
+        return {
+            name: stringToHex(username, { size: 32 }),
+            id: stringToHex(id, { size: 32 }),
+            domainName: stringToHex(domainName, { size: 32 }),
+            validUntil: BigInt(validUntil),
+            nonce: 0n,
+        };
+    };
+    /**
+     * Creates a name query by address
+     * @param params - Parameters for creating the query
+     * @param params.address - Address to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByAddress = ({ address, domainName, targetDomain, }) => {
+        if (!isAddress(address))
+            throw new Error("formQueryByAddress: is not a valid address");
+        return {
+            name: stringToHex("", { size: 32 }),
+            id: stringToHex("", { size: 32 }),
+            wallet: address,
+            domainName: stringToHex(domainName, { size: 32 }),
+            targetDomain: stringToHex(targetDomain ?? "", { size: 32 }),
+        };
+    };
+    /**
+     * Creates a name query by ID
+     * @param params - Parameters for creating the query
+     * @param params.id - ID to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryById = ({ id, domainName, targetDomain, }) => {
+        return {
+            name: stringToHex("", { size: 32 }),
+            id: stringToHex(id, { size: 32 }),
+            wallet: zeroAddress,
+            domainName: stringToHex(domainName, { size: 32 }),
+            targetDomain: stringToHex(targetDomain ?? "", { size: 32 }),
+        };
+    };
+    /**
+     * Creates a name query by username
+     * @param params - Parameters for creating the query
+     * @param params.username - Username to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByUsername = ({ username, domainName, targetDomain, }) => {
+        return {
+            name: stringToHex(username, { size: 32 }),
+            id: "0x",
+            wallet: zeroAddress,
+            domainName: stringToHex(domainName, { size: 32 }),
+            targetDomain: stringToHex(targetDomain ?? "", { size: 32 }),
+        };
+    };
+    /**
+     * Creates a name query by username and ID
+     * @param params - Parameters for creating the query
+     * @param params.username - Username to be encoded in the query
+     * @param params.id - ID to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByUsernameAndId = ({ username, id, domainName, targetDomain, }) => {
+        return {
+            name: stringToHex(username, { size: 32 }),
+            id: stringToHex(id, { size: 32 }),
+            wallet: zeroAddress,
+            domainName: stringToHex(domainName, { size: 32 }),
+            targetDomain: stringToHex(targetDomain ?? "", { size: 32 }),
+        };
+    };
+    /**
+     * Creates a name query with full details
+     * @param params - Parameters for creating the query
+     * @param params.username - Username to be encoded in the query
+     * @param params.id - ID to be encoded in the query
+     * @param params.domainName - Domain name to be encoded in the query
+     * @param params.targetDomain - Target domain to be encoded in the query
+     * @param params.address - Address to be encoded in the query
+     * @returns The generated name query
+     */
+    formQueryByFullDetails = ({ username, id, domainName, targetDomain, address, }) => {
+        if (!isAddress(address))
+            throw new Error("formQueryByAddress: is not a valid address");
+        return {
+            name: stringToHex(username, { size: 32 }),
+            id: stringToHex(id, { size: 32 }),
+            wallet: address,
+            domainName: stringToHex(domainName, { size: 32 }),
+            targetDomain: stringToHex(targetDomain ?? "", { size: 32 }),
+        };
+    };
+}
+//# sourceMappingURL=MultipassBase.js.map

package/lib.esm/multipass/MultipassBase.js.map

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

package/lib.esm/multipass/Registrar.d.ts

@@ -0,0 +1,58 @@
+import { type Address, type WalletClient, type Hex } from "viem";
+import type { RegisterMessage } from "../types";
+import MultipassBase from "./MultipassBase";
+/**
+ * Structure representing a name query for Multipass
+ * @public
+ */
+export type NameQuery = {
+    /** Hex-encoded name */
+    name: Hex;
+    /** Hex-encoded ID */
+    id: Hex;
+    /** Wallet address */
+    wallet: Address;
+    /** Hex-encoded domain name */
+    domainName: Hex;
+    /** Hex-encoded target domain */
+    targetDomain: Hex;
+};
+/**
+ * Main Multipass class for handling registrations and queries
+ * @extends MultipassBase
+ */
+export default class Multipass extends MultipassBase {
+    /** Name of the contract */
+    private name;
+    /** Version of the contract */
+    private version;
+    /** Wallet client for signing transactions */
+    private walletClient;
+    /**
+     * Creates a new Multipass instance
+     * @param params - Constructor parameters
+     * @param params.chainId - ID of the blockchain network
+     * @param params.walletClient - Wallet client for signing transactions
+     */
+    constructor({ chainId, walletClient }: {
+        chainId: number;
+        walletClient: WalletClient;
+    });
+    /**
+     * Signs a registrar message for registration
+     * @param message - Message to sign
+     * @param verifierAddress - Address of the verifier contract
+     * @returns Signed message
+     */
+    signRegistrarMessage: (message: RegisterMessage, verifierAddress: Address) => Promise<`0x${string}`>;
+    /**
+     * Generates a URL for a dapp
+     * @param message - Message object to be encoded in the URL
+     * @param signature - Signature to be encoded in the URL
+     * @param basepath - Base path of the URL
+     * @param contractAddress - Address of the contract
+     * @returns The generated URL
+     */
+    getDappURL(message: object, signature: string, basepath: string, contractAddress: string): string;
+}
+//# sourceMappingURL=Registrar.d.ts.map

package/lib.esm/multipass/Registrar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registrar.d.ts","sourceRoot":"","sources":["../../../src/multipass/Registrar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,GAAG,EAAmB,MAAM,MAAM,CAAC;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAE5C;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,uBAAuB;IACvB,IAAI,EAAE,GAAG,CAAC;IACV,qBAAqB;IACrB,EAAE,EAAE,GAAG,CAAC;IACR,qBAAqB;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,8BAA8B;IAC9B,UAAU,EAAE,GAAG,CAAC;IAChB,gCAAgC;IAChC,YAAY,EAAE,GAAG,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,aAAa;IAClD,2BAA2B;IAC3B,OAAO,CAAC,IAAI,CAAS;IACrB,8BAA8B;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,6CAA6C;IAC7C,OAAO,CAAC,YAAY,CAAe;IAEnC;;;;;OAKG;gBACS,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE;IAQtF;;;;;OAKG;IACI,oBAAoB,YAAmB,eAAe,mBAAmB,OAAO,4BA2BrF;IAEF;;;;;;;OAOG;IACI,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM;CAGzG"}

package/lib.esm/multipass/Registrar.js

@@ -0,0 +1,71 @@
+import { getArtifact } from "../utils";
+import MultipassBase from "./MultipassBase";
+/**
+ * Main Multipass class for handling registrations and queries
+ * @extends MultipassBase
+ */
+export default class Multipass extends MultipassBase {
+    /** Name of the contract */
+    name;
+    /** Version of the contract */
+    version;
+    /** Wallet client for signing transactions */
+    walletClient;
+    /**
+     * Creates a new Multipass instance
+     * @param params - Constructor parameters
+     * @param params.chainId - ID of the blockchain network
+     * @param params.walletClient - Wallet client for signing transactions
+     */
+    constructor({ chainId, walletClient }) {
+        super({ chainId });
+        const artifact = getArtifact(chainId, "Multipass");
+        this.name = artifact.execute.args[0];
+        this.version = artifact.execute.args[1];
+        this.walletClient = walletClient;
+    }
+    /**
+     * Signs a registrar message for registration
+     * @param message - Message to sign
+     * @param verifierAddress - Address of the verifier contract
+     * @returns Signed message
+     */
+    signRegistrarMessage = async (message, verifierAddress) => {
+        if (!this.walletClient.account?.address)
+            throw new Error("No account found");
+        const domain = {
+            name: this.name,
+            version: this.version,
+            chainId: this.chainId,
+            verifyingContract: verifierAddress,
+        };
+        const types = {
+            registerName: [
+                { type: "bytes32", name: "name" },
+                { type: "bytes32", name: "id" },
+                { type: "bytes32", name: "domainName" },
+                { type: "uint256", name: "validUntil" },
+                { type: "uint96", name: "nonce" },
+            ],
+        };
+        return this.walletClient.signTypedData({
+            account: this.walletClient.account.address,
+            domain: domain,
+            types,
+            primaryType: "registerName",
+            message: { ...message },
+        });
+    };
+    /**
+     * Generates a URL for a dapp
+     * @param message - Message object to be encoded in the URL
+     * @param signature - Signature to be encoded in the URL
+     * @param basepath - Base path of the URL
+     * @param contractAddress - Address of the contract
+     * @returns The generated URL
+     */
+    getDappURL(message, signature, basepath, contractAddress) {
+        return super.getDappURL(message, signature, basepath, contractAddress);
+    }
+}
+//# sourceMappingURL=Registrar.js.map

package/lib.esm/multipass/Registrar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Registrar.js","sourceRoot":"","sources":["../../../src/multipass/Registrar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAmB5C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,aAAa;IAClD,2BAA2B;IACnB,IAAI,CAAS;IACrB,8BAA8B;IACtB,OAAO,CAAS;IACxB,6CAA6C;IACrC,YAAY,CAAe;IAEnC;;;;;OAKG;IACH,YAAY,EAAE,OAAO,EAAE,YAAY,EAAmD;QACpF,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACnB,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACI,oBAAoB,GAAG,KAAK,EAAE,OAAwB,EAAE,eAAwB,EAAE,EAAE;QACzF,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAE7E,MAAM,MAAM,GAAoB;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,iBAAiB,EAAE,eAAe;SACnC,CAAC;QAEF,MAAM,KAAK,GAAG;YACZ,YAAY,EAAE;gBACZ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE;gBACjC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE;gBAC/B,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE;gBACvC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE;gBACvC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE;aAClC;SACO,CAAC;QAEX,OAAO,IAAI,CAAC,YAAY,CAAC,aAAa,CAAC;YACrC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO;YAC1C,MAAM,EAAE,MAAM;YACd,KAAK;YACL,WAAW,EAAE,cAAc;YAC3B,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE;SACxB,CAAC,CAAC;IACL,CAAC,CAAC;IAEF;;;;;;;OAOG;IACI,UAAU,CAAC,OAAe,EAAE,SAAiB,EAAE,QAAgB,EAAE,eAAuB;QAC7F,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;IACzE,CAAC;CACF"}

package/lib.esm/rankify/GameMaster.d.ts

@@ -0,0 +1,171 @@
+import { Address, WalletClient, PublicClient, Hex } from "viem";
+import InstanceBase from "./InstanceBase";
+/**
+ * GameMaster class for managing game state and cryptographic operations in Rankify
+ * Extends InstanceBase to provide game master specific functionality
+ * @public
+ */
+export declare class GameMaster extends InstanceBase {
+    EIP712name: string;
+    EIP712Version: string;
+    walletClient: WalletClient;
+    encryptionCallback: (data: string) => Promise<string>;
+    decryptionCallback: (data: string) => Promise<string>;
+    randomnessCallback: () => Promise<number>;
+    turnSaltCallback: ({ gameId, turn }: {
+        gameId: bigint;
+        turn: bigint;
+    }) => Promise<Hex>;
+    /**
+     * Creates a new GameMaster instance
+     * @param EIP712name - Name for EIP712 signing
+     * @param EIP712Version - Version for EIP712 signing
+     * @param instanceAddress - Address of the Rankify game instance
+     * @param walletClient - Viem wallet client for transactions
+     * @param publicClient - Viem public client for reading state
+     * @param chainId - Chain ID of the network
+     * @param encryptionCallback - Callback function for encrypting data
+     * @param decryptionCallback - Callback function for decrypting data
+     * @param randomnessCallback - Callback function for generating random numbers
+     * @param turnSaltCallback - Callback function for generating turn salts
+     */
+    constructor({ EIP712name, EIP712Version, instanceAddress, walletClient, publicClient, chainId, encryptionCallback, decryptionCallback, randomnessCallback, turnSaltCallback, }: {
+        EIP712name: string;
+        EIP712Version: string;
+        instanceAddress: Address;
+        walletClient: WalletClient;
+        publicClient: PublicClient;
+        chainId: number;
+        encryptionCallback: (data: string) => Promise<string>;
+        decryptionCallback: (data: string) => Promise<string>;
+        randomnessCallback: () => Promise<number>;
+        turnSaltCallback: ({ gameId, turn }: {
+            gameId: bigint;
+            turn: bigint;
+        }) => Promise<Hex>;
+    });
+    /**
+     * Decrypts proposals for a specific game turn
+     * @param gameId - ID of the game
+     * @param turn - Turn number
+     * @param proposer - Optional proposer address to filter proposals
+     * @returns Array of decrypted proposals with proposer addresses
+     */
+    decryptProposals: (gameId: bigint, turn: bigint, proposer?: Address) => Promise<{
+        proposer: `0x${string}` | undefined;
+        proposal: string;
+    }[]>;
+    /**
+     * Shuffles an array using cryptographically secure randomness
+     * @param array - Array to shuffle
+     * @returns Shuffled array
+     */
+    shuffle: <T>(array: T[]) => Promise<T[]>;
+    /**
+     * Generates a salt for a specific game turn
+     * @param gameId - ID of the game
+     * @param turn - Turn number
+     * @returns Generated salt as Hex
+     */
+    getTurnSalt: ({ gameId, turn }: {
+        gameId: bigint;
+        turn: bigint;
+    }) => Promise<`0x${string}`>;
+    /**
+     * Generates a salt for a specific player in a game turn
+     * @param gameId - ID of the game
+     * @param turn - Turn number
+     * @param proposer - Address of the proposer
+     * @returns Generated salt as Hex
+     */
+    getTurnPlayersSalt: ({ gameId, turn, proposer }: {
+        gameId: bigint;
+        turn: bigint;
+        proposer: Address;
+    }) => Promise<`0x${string}`>;
+    /**
+     * Finds the index of a player's ongoing proposal
+     * @param gameId - ID of the game
+     * @param player - Address of the player
+     * @returns Index of the player's proposal, -1 if not found
+     */
+    findPlayerOngoingProposalIndex: (gameId: bigint, player: Address) => Promise<number>;
+    /**
+     * Submits a vote for proposals
+     * @param gameId - ID of the game
+     * @param vote - Array of vote values
+     * @param voter - Address of the voter
+     * @returns Transaction hash
+     */
+    submitVote: (gameId: bigint, vote: bigint[], voter: Address) => Promise<`0x${string}`>;
+    /**
+     * Gets the hidden proposer hash for a specific game turn
+     * @param gameId - ID of the game
+     * @param turn - Turn number
+     * @param proposer - Address of the proposer
+     * @returns Hidden proposer hash
+     */
+    proposerHidden: ({ gameId, turn, proposer }: {
+        gameId: bigint;
+        turn: bigint;
+        proposer: Address;
+    }) => Promise<`0x${string}`>;
+    /**
+     * Submits a proposal to the game
+     * @param gameId - ID of the game
+     * @param commitmentHash - Hash of the proposal commitment
+     * @param encryptedProposal - Encrypted proposal data
+     * @param proposer - Address of the proposer
+     * @returns Transaction hash
+     */
+    submitProposal: ({ gameId, commitmentHash, proposal, proposer, }: {
+        gameId: bigint;
+        commitmentHash: Hex;
+        proposal: string;
+        proposer: Address;
+    }) => Promise<`0x${string}`>;
+    /**
+     * Decrypts votes for a specific game turn
+     * @param gameId - ID of the game
+     * @param turn - Turn number
+     * @returns Array of decrypted votes with player addresses
+     */
+    decryptTurnVotes: (gameId: bigint, turn: bigint) => Promise<{
+        player: `0x${string}`;
+        votes: bigint[];
+    }[]>;
+    /**
+     * Decrypts all votes for the current game turn
+     * @param gameId - ID of the game
+     * @returns Array of decrypted votes with player addresses
+     */
+    decryptVotes: (gameId: bigint) => Promise<-1 | {
+        player: `0x${string}`;
+        votes: bigint[];
+    }[]>;
+    /**
+     * Checks if the current turn can be ended
+     * @param gameId - ID of the game
+     * @returns Boolean indicating if turn can be ended
+     */
+    canEndTurn: (gameId: bigint) => Promise<never>;
+    /**
+     * Gets the current turn number
+     * @param gameId - ID of the game
+     * @returns Current turn number
+     */
+    currentTurn: (gameId: bigint) => Promise<never>;
+    /**
+     * Gets the list of players in the game
+     * @param gameId - ID of the game
+     * @returns Array of player addresses
+     */
+    getPlayers: (gameId: bigint) => Promise<never>;
+    /**
+     * Ends the current turn and processes votes
+     * @param gameId - ID of the game
+     * @returns Transaction hash
+     */
+    endTurn: (gameId: bigint) => Promise<`0x${string}`>;
+}
+//# sourceMappingURL=GameMaster.d.ts.map

package/lib.esm/rankify/GameMaster.d.ts.map

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