@peeramid-labs/sdk 1.0.0

package/lib.commonjs/eds/Distributor.d.ts

@@ -0,0 +1,17 @@
+import { type Address, Hex, PublicClient } from "viem";
+export declare class DistributorClient {
+    publicClient: PublicClient;
+    address: Address;
+    constructor({ address, publicClient }: {
+        address: Address;
+        publicClient: PublicClient;
+    });
+    getDistributions(): Promise<readonly `0x${string}`[]>;
+    getInstances(distributorsId: Hex): Promise<Address[][]>;
+    getInstance(distributorsId: Hex, instanceId: bigint): Promise<Address[]>;
+    getNamedDistributionInstances({ namedDistribution }: {
+        namedDistribution: string;
+    }): Promise<Address[][]>;
+    getNamedDistributionInstance(namedDistribution: string, instanceId: bigint): Promise<Address[]>;
+}
+//# sourceMappingURL=Distributor.d.ts.map

package/lib.commonjs/eds/Distributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Distributor.d.ts","sourceRoot":"","sources":["../../../src/eds/Distributor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAA4B,GAAG,EAAE,YAAY,EAAc,MAAM,MAAM,CAAC;AAG7F,qBAAa,iBAAiB;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;gBAEL,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,YAAY,CAAA;KAAE;IAKjF,gBAAgB;IAShB,YAAY,CAAC,cAAc,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IAiBvD,WAAW,CAAC,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAyBxE,6BAA6B,CAAC,EAAE,iBAAiB,EAAE,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;IAKzG,4BAA4B,CAAC,iBAAiB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAItG"}

package/lib.commonjs/eds/Distributor.js

@@ -0,0 +1,65 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DistributorClient = void 0;
+const viem_1 = require("viem");
+const Distributor_1 = __importDefault(require("../abis/Distributor"));
+class DistributorClient {
+    publicClient;
+    address;
+    constructor({ address, publicClient }) {
+        this.address = (0, viem_1.getAddress)(address, publicClient?.chain?.id);
+        this.publicClient = publicClient;
+    }
+    async getDistributions() {
+        const contract = (0, viem_1.getContract)({
+            address: (0, viem_1.getAddress)(this.address),
+            abi: Distributor_1.default,
+            client: this.publicClient,
+        });
+        return contract.read.getDistributions();
+    }
+    async getInstances(distributorsId) {
+        const contract = (0, viem_1.getContract)({
+            address: this.address,
+            abi: Distributor_1.default,
+            client: this.publicClient,
+        });
+        const events = await contract.getEvents.Instantiated({
+            distributionId: distributorsId,
+        }, { toBlock: "latest", fromBlock: 1n } //ToDo: Parametrize this
+        );
+        return events.map((log) => log.args.instances);
+    }
+    async getInstance(distributorsId, instanceId) {
+        const contract = (0, viem_1.getContract)({
+            address: this.address,
+            abi: Distributor_1.default,
+            client: this.publicClient,
+        });
+        const events = await contract.getEvents.Instantiated({
+            distributionId: distributorsId,
+            newInstanceId: instanceId,
+        }, { toBlock: "latest", fromBlock: 1n } //ToDo: Parametrize this
+        );
+        if (events.length > 1) {
+            throw new Error(`Multiple instances found for distributor ${distributorsId} and instance ${instanceId}`);
+        }
+        if (events.length === 0) {
+            throw new Error(`No instances found for distributor ${distributorsId} and instance ${instanceId}`);
+        }
+        return events[0].args.instances;
+    }
+    async getNamedDistributionInstances({ namedDistribution }) {
+        const id = (0, viem_1.stringToHex)(namedDistribution, { size: 32 });
+        return this.getInstances(id);
+    }
+    async getNamedDistributionInstance(namedDistribution, instanceId) {
+        const id = (0, viem_1.stringToHex)(namedDistribution, { size: 32 });
+        return this.getInstance(id, instanceId);
+    }
+}
+exports.DistributorClient = DistributorClient;
+//# sourceMappingURL=Distributor.js.map

package/lib.commonjs/eds/Distributor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Distributor.js","sourceRoot":"","sources":["../../../src/eds/Distributor.ts"],"names":[],"mappings":";;;;;;AAAA,+BAA6F;AAC7F,sEAAiD;AAEjD,MAAa,iBAAiB;IAC5B,YAAY,CAAe;IAC3B,OAAO,CAAU;IAEjB,YAAY,EAAE,OAAO,EAAE,YAAY,EAAoD;QACrF,IAAI,CAAC,OAAO,GAAG,IAAA,iBAAU,EAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,MAAM,QAAQ,GAAG,IAAA,kBAAW,EAAC;YAC3B,OAAO,EAAE,IAAA,iBAAU,EAAC,IAAI,CAAC,OAAO,CAAC;YACjC,GAAG,EAAE,qBAAc;YACnB,MAAM,EAAE,IAAI,CAAC,YAAY;SAC1B,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,cAAmB;QACpC,MAAM,QAAQ,GAAG,IAAA,kBAAW,EAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,qBAAc;YACnB,MAAM,EAAE,IAAI,CAAC,YAAY;SAC1B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,YAAY,CAClD;YACE,cAAc,EAAE,cAAc;SAC/B,EACD,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,wBAAwB;SAC9D,CAAC;QAEF,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAsB,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,cAAmB,EAAE,UAAkB;QACvD,MAAM,QAAQ,GAAG,IAAA,kBAAW,EAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,qBAAc;YACnB,MAAM,EAAE,IAAI,CAAC,YAAY;SAC1B,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,YAAY,CAClD;YACE,cAAc,EAAE,cAAc;YAC9B,aAAa,EAAE,UAAU;SAC1B,EACD,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,wBAAwB;SAC9D,CAAC;QAEF,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4CAA4C,cAAc,iBAAiB,UAAU,EAAE,CAAC,CAAC;QAC3G,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,sCAAsC,cAAc,iBAAiB,UAAU,EAAE,CAAC,CAAC;QACrG,CAAC;QAED,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAsB,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,6BAA6B,CAAC,EAAE,iBAAiB,EAAiC;QACtF,MAAM,EAAE,GAAG,IAAA,kBAAW,EAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,4BAA4B,CAAC,iBAAyB,EAAE,UAAkB;QAC9E,MAAM,EAAE,GAAG,IAAA,kBAAW,EAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;CACF;AArED,8CAqEC"}

package/lib.commonjs/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file Main entry point for the Rankify SDK
+ * Exports core components and utilities for interacting with Peeramid protocol
+ */
+export { default as Multipass } from "./multipass/Registrar";
+export { default as InstanceBase } from "./rankify/InstanceBase";
+export { default as InstancePlayer } from "./rankify/Player";
+export { default as MultipassBase, NameQuery } from "./multipass/MultipassBase";
+export { default as Registrar } from "./multipass/Registrar";
+export * from "./utils";
+export * from "./types";
+export * from "./rankify/MAODistributor";
+export { gameStatusEnum } from "./rankify/InstanceBase";
+export { MAOInstances } from "./types/contracts";
+export { abis } from "./abis/index";
+//# sourceMappingURL=index.d.ts.map

package/lib.commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAG7D,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,0BAA0B,CAAC;AAGzC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC"}

package/lib.commonjs/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @file Main entry point for the Rankify SDK
+ * Exports core components and utilities for interacting with Peeramid protocol
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.abis = exports.gameStatusEnum = exports.Registrar = exports.MultipassBase = exports.InstancePlayer = exports.InstanceBase = exports.Multipass = void 0;
+// Core exports
+var Registrar_1 = require("./multipass/Registrar");
+Object.defineProperty(exports, "Multipass", { enumerable: true, get: function () { return __importDefault(Registrar_1).default; } });
+var InstanceBase_1 = require("./rankify/InstanceBase");
+Object.defineProperty(exports, "InstanceBase", { enumerable: true, get: function () { return __importDefault(InstanceBase_1).default; } });
+var Player_1 = require("./rankify/Player");
+Object.defineProperty(exports, "InstancePlayer", { enumerable: true, get: function () { return __importDefault(Player_1).default; } });
+var MultipassBase_1 = require("./multipass/MultipassBase");
+Object.defineProperty(exports, "MultipassBase", { enumerable: true, get: function () { return __importDefault(MultipassBase_1).default; } });
+var Registrar_2 = require("./multipass/Registrar");
+Object.defineProperty(exports, "Registrar", { enumerable: true, get: function () { return __importDefault(Registrar_2).default; } });
+// Utility exports
+__exportStar(require("./utils"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./rankify/MAODistributor"), exports);
+// Type exports
+var InstanceBase_2 = require("./rankify/InstanceBase");
+Object.defineProperty(exports, "gameStatusEnum", { enumerable: true, get: function () { return InstanceBase_2.gameStatusEnum; } });
+// Re-export the abis object
+var index_1 = require("./abis/index");
+Object.defineProperty(exports, "abis", { enumerable: true, get: function () { return index_1.abis; } });
+//# sourceMappingURL=index.js.map

package/lib.commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;;;;AAEH,eAAe;AACf,mDAA6D;AAApD,uHAAA,OAAO,OAAa;AAC7B,uDAAiE;AAAxD,6HAAA,OAAO,OAAgB;AAChC,2CAA6D;AAApD,yHAAA,OAAO,OAAkB;AAClC,2DAAgF;AAAvE,+HAAA,OAAO,OAAiB;AACjC,mDAA6D;AAApD,uHAAA,OAAO,OAAa;AAE7B,kBAAkB;AAClB,0CAAwB;AACxB,0CAAwB;AACxB,2DAAyC;AAEzC,eAAe;AACf,uDAAwD;AAA/C,8GAAA,cAAc,OAAA;AAGvB,4BAA4B;AAC5B,sCAAoC;AAA3B,6FAAA,IAAI,OAAA"}

package/lib.commonjs/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.commonjs/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.commonjs/multipass/MultipassBase.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const viem_1 = require("viem");
+/**
+ * Base class for Multipass functionality
+ */
+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: (0, viem_1.stringToHex)(username, { size: 32 }),
+            id: (0, viem_1.stringToHex)(id, { size: 32 }),
+            domainName: (0, viem_1.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 (!(0, viem_1.isAddress)(address))
+            throw new Error("formQueryByAddress: is not a valid address");
+        return {
+            name: (0, viem_1.stringToHex)("", { size: 32 }),
+            id: (0, viem_1.stringToHex)("", { size: 32 }),
+            wallet: address,
+            domainName: (0, viem_1.stringToHex)(domainName, { size: 32 }),
+            targetDomain: (0, viem_1.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: (0, viem_1.stringToHex)("", { size: 32 }),
+            id: (0, viem_1.stringToHex)(id, { size: 32 }),
+            wallet: viem_1.zeroAddress,
+            domainName: (0, viem_1.stringToHex)(domainName, { size: 32 }),
+            targetDomain: (0, viem_1.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: (0, viem_1.stringToHex)(username, { size: 32 }),
+            id: "0x",
+            wallet: viem_1.zeroAddress,
+            domainName: (0, viem_1.stringToHex)(domainName, { size: 32 }),
+            targetDomain: (0, viem_1.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: (0, viem_1.stringToHex)(username, { size: 32 }),
+            id: (0, viem_1.stringToHex)(id, { size: 32 }),
+            wallet: viem_1.zeroAddress,
+            domainName: (0, viem_1.stringToHex)(domainName, { size: 32 }),
+            targetDomain: (0, viem_1.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 (!(0, viem_1.isAddress)(address))
+            throw new Error("formQueryByAddress: is not a valid address");
+        return {
+            name: (0, viem_1.stringToHex)(username, { size: 32 }),
+            id: (0, viem_1.stringToHex)(id, { size: 32 }),
+            wallet: address,
+            domainName: (0, viem_1.stringToHex)(domainName, { size: 32 }),
+            targetDomain: (0, viem_1.stringToHex)(targetDomain ?? "", { size: 32 }),
+        };
+    };
+}
+exports.default = MultipassBase;
+//# sourceMappingURL=MultipassBase.js.map

package/lib.commonjs/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.commonjs/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.commonjs/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.commonjs/multipass/Registrar.js

@@ -0,0 +1,77 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("../utils");
+const MultipassBase_1 = __importDefault(require("./MultipassBase"));
+/**
+ * Main Multipass class for handling registrations and queries
+ * @extends MultipassBase
+ */
+class Multipass extends MultipassBase_1.default {
+    /** 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 = (0, utils_1.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);
+    }
+}
+exports.default = Multipass;
+//# sourceMappingURL=Registrar.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Registrar.js","sourceRoot":"","sources":["../../../src/multipass/Registrar.ts"],"names":[],"mappings":";;;;;AACA,oCAAuC;AAEvC,oEAA4C;AAmB5C;;;GAGG;AACH,MAAqB,SAAU,SAAQ,uBAAa;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,IAAA,mBAAW,EAAC,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;AApED,4BAoEC"}