@nevermined-io/core-kit 0.1.4 → 0.1.6

package/dist/errors/NeverminedErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeverminedErrors.d.ts","sourceRoot":"","sources":["../../src/errors/NeverminedErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAG1C;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,wBAAyB,SAAQ,QAAQ;gBACxC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,CAAC,EAAE,OAAO;CAG9B;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAG5B;AAED,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;CAW1C;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;CAG9C;AAED,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;CAG/C;AAED,qBAAa,yBAA0B,SAAQ,QAAQ;gBACzC,aAAa,EAAE,MAAM;CAGlC;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM;CAGtD;AAED,qBAAa,qBAAsB,SAAQ,QAAQ;gBACrC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;CAG9C;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAG5B"}

package/dist/errors/NeverminedErrors.js

@@ -0,0 +1,128 @@
+export class NeverminedNodeError extends Error {
+    constructor(message) {
+        super(`Nevermined Node error: ${message}`);
+    }
+}
+export class GraphError extends Error {
+    constructor(message) {
+        super(`Graph error: ${message}`);
+    }
+}
+export class HttpError extends Error {
+    constructor(message, code) {
+        super(`Http error with code ${code}: ${message}`);
+    }
+}
+export class ContractsError extends Error {
+    constructor(message) {
+        super(`Contracts error: ${message}`);
+    }
+}
+export class ContractSimulationError extends Error {
+    constructor(message) {
+        super(`Contract simulation error: ${message}`);
+    }
+}
+export class Web3Error extends Error {
+    constructor(message) {
+        super(`Web3 error: ${message}`);
+    }
+}
+export class ApiError extends Error {
+    constructor(message) {
+        super(`Api error: ${message}`);
+    }
+}
+export class NFTError extends Error {
+    constructor(message) {
+        super(`NFT error: ${message}`);
+    }
+}
+export class DynamicCreditsOverLimit extends NFTError {
+    constructor(message) {
+        super(`DynamicCreditsOverLimit error: ${message}`);
+    }
+}
+export class DynamicCreditsUnderLimit extends NFTError {
+    constructor(message) {
+        super(`DynamicCreditsUnderLimit error: ${message}`);
+    }
+}
+export class InvalidAddress extends Error {
+    constructor(address) {
+        super(`Invalid Address ${address}`);
+    }
+}
+export class NotEnoughBalance extends Error {
+    constructor(message) {
+        super(`NotEnoughBalance: ${message}`);
+    }
+}
+export class MethodNotSupported extends Error {
+    constructor(message) {
+        super(`MethodNotSupported: ${message}`);
+    }
+}
+export class PlanNotFound extends Error {
+    constructor(message) {
+        super(`PlanNotFound: ${message}`);
+    }
+}
+export class AgentNotFound extends Error {
+    constructor(message) {
+        super(`AgentNotFound: ${message}`);
+    }
+}
+export class AssetError extends Error {
+    constructor(message) {
+        super(`Asset error: ${message}`);
+    }
+}
+export class PaymentFeesNotIncluded extends Error {
+    constructor(message) {
+        super(`PaymentFeesNotIncluded: ${message}`);
+    }
+}
+export class DDOError extends Error {
+    constructor(message, did) {
+        if (did) {
+            super(`DDO(${did}) error: ${message}`);
+        }
+        else {
+            super(`DDO error: ${message}`);
+        }
+        // from https://bobbyhadz.com/blog/typescript-extend-error-class
+        // 👇️ because we are extending a built-in class
+        Object.setPrototypeOf(this, DDOError.prototype);
+    }
+}
+export class DDOServiceNotFoundError extends DDOError {
+    constructor(serviceType, did) {
+        super(`Service with type "${serviceType}" not found`, did);
+    }
+}
+export class DDOServiceAlreadyExists extends DDOError {
+    constructor(serviceType, index) {
+        super(`Service with type "${serviceType}" and index ${index} already exists`);
+    }
+}
+export class DDOConditionNotFoundError extends DDOError {
+    constructor(conditionName) {
+        super(`Condition with name "${conditionName}" not found`);
+    }
+}
+export class DDOParamNotFoundError extends DDOError {
+    constructor(conditionName, paramName) {
+        super(`Parameter "${paramName}" not found on Condition with type "${conditionName}"`);
+    }
+}
+export class DDOPriceNotFoundError extends DDOError {
+    constructor(serviceType, did) {
+        super(`Service with type "${serviceType}" is not priced.`, did);
+    }
+}
+export class NvmAccountError extends Error {
+    constructor(message) {
+        super(`NVM Account error: ${message}`);
+    }
+}

package/dist/errors/index.d.ts

@@ -0,0 +1,2 @@
+export * from './NeverminedErrors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA"}

package/dist/errors/index.js

@@ -0,0 +1 @@
+export * from './NeverminedErrors.js';

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from './contracts/index.js';
+export * from './models/index.js';
+export * from './nevermined/index.js';
+export * from './nevermined/Nevermined.js';
+export * from './errors/index.js';
+export * from './Instantiable.abstract.js';
+export * from './utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA;AACrC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AAEjC,cAAc,4BAA4B,CAAA;AAG1C,cAAc,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from './contracts/index.js';
+export * from './models/index.js';
+export * from './nevermined/index.js';
+export * from './nevermined/Nevermined.js';
+export * from './errors/index.js';
+export * from './Instantiable.abstract.js';
+// Utils
+export * from './utils/index.js';

package/dist/models/AgentAccessToken.d.ts

@@ -0,0 +1,123 @@
+import { JWTPayload } from 'jose';
+import { Account } from 'viem';
+import { SmartAccount } from 'viem/account-abstraction';
+import { SignatureUtils } from '../nevermined/utils/SignatureUtils.js';
+/**
+ * The access to remote agents is granted through an authorization token.
+ * This token is generated using the AgentAccessToken JWT structure.
+ * AgentAccessToken:
+ *   authToken: JWTAuthTokenParams
+ *   proof: JWTRedemptionProofParams
+ */
+export interface JWTAuthTokenParams {
+    /**
+     * The agent identifier related with the authorization token.
+     */
+    agentId: string;
+    /**
+     * The plan identifier related with the authorization token.
+     */
+    planId: string;
+    /**
+     * The public address of the account the key is issued for.
+     */
+    sub: `0x${string}`;
+    /**
+     * The public address of the account issuing the key.
+     */
+    iss?: `0x${string}`;
+    /**
+     * The chain id of the network the token is valid for. If zero the key is not having any network limitation
+     */
+    aud?: string;
+    /**
+     * JWT Expiration Time
+     *
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.4 RFC7519#section-4.1.4}
+     */
+    exp?: number;
+    /**
+     * JWT Issued At
+     *
+     * @see {@link https://www.rfc-editor.org/rfc/rfc7519#section-4.1.6 RFC7519#section-4.1.6}
+     */
+    iat?: number;
+    [key: string]: unknown;
+}
+export interface JWTRedemptionProofParams {
+    keyspace: string;
+    nonce: string;
+    planIds: string[];
+}
+export declare class AgentAccessToken implements JWTPayload {
+    /**
+     * The version of the access token
+     */
+    ver?: string;
+    /**
+     * The authorization token used to query the agent.
+     * This token is validated by the agent or proxy to ensure the request is authorized
+     * {@see {@link AgentAuthTokenParams}}
+     */
+    authToken?: string;
+    /**
+     * The proof generated by the subscriber (sub) to prove the request to query the agent
+     * {@see {@link JWTRedemptionProofParams}
+     */
+    proof?: string;
+    iss?: string | undefined;
+    sub?: string | undefined;
+    aud?: string | string[] | undefined;
+    exp?: number;
+    iat?: number;
+    [propName: string]: unknown;
+    _signatureUtils: SignatureUtils;
+    _issuerAccount: Account | SmartAccount;
+    private constructor();
+    /**
+     * It generates a new serialized and encrypted NvmApiKey including the ZeroDev session key and the Marketplace auth token.
+     * The string  representing this key can be used to authenticate against the Nevermined API.
+     * @param signatureUtils The SignatureUtils instance
+     * @param issuerAccount The account issuing the key
+    
+     */
+    static generate(signatureUtils: SignatureUtils, issuerAccount: Account | SmartAccount, agentId: string | bigint, planId: string | bigint, subscriberAddress: `0x${string}`, expirationTime?: number | string, version?: string): Promise<AgentAccessToken>;
+    setRedemptionProof(keyspace: string, nonce: string): Promise<this>;
+    decodeAuthToken(): JWTAuthTokenParams;
+    /**
+     * It serializes the NVM Api Key into a string
+     * @returns a string representing the NVM API Key
+     */
+    serialize(): string;
+    /**
+     * It serializes the NVM Api Key into a string
+     * @returns a string representing the NVM API Key
+     */
+    toString(): string;
+    /**
+     * It generates a signed JWT from the NvmApiKey
+     * @param signatureUtils The SignatureUtils instance
+     * @param issuerAccount The account issuing the key
+     * @returns the string in JWT format represeting the NvmApiKey
+     */
+    toJWT(): Promise<string>;
+    static fromJWT(jwtString: string, signatureUtils: SignatureUtils, issuerAddress: Account | SmartAccount): AgentAccessToken;
+    /**
+     * It decodes a string JWT into a JWTPayload
+     * @param str jwt string
+     * @returns the JWTPayload
+     */
+    static decodeJWT(str: string): JWTPayload;
+    /**
+     * It generates the hash of the NvmApiKey
+     * @returns a string representing the hash of the NvmApiKey
+     */
+    hash(): string;
+    /**
+     * Given a serialized string, it generates the hash
+     * @param serialized the serialized string
+     * @returns the hash
+     */
+    static hash(serialized: string): string;
+}
+//# sourceMappingURL=AgentAccessToken.d.ts.map

package/dist/models/AgentAccessToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentAccessToken.d.ts","sourceRoot":"","sources":["../../src/models/AgentAccessToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAa,MAAM,MAAM,CAAA;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAEtE;;;;;;GAMG;AAEH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,GAAG,EAAE,KAAK,MAAM,EAAE,CAAA;IAClB;;OAEG;IACH,GAAG,CAAC,EAAE,KAAK,MAAM,EAAE,CAAA;IACnB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,qBAAa,gBAAiB,YAAW,UAAU;IACjD;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAA;IACnC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IAE3B,eAAe,EAAE,cAAc,CAAA;IAC/B,cAAc,EAAE,OAAO,GAAG,YAAY,CAAA;IAEtC,OAAO;IAMP;;;;;;OAMG;WACiB,QAAQ,CAC1B,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,OAAO,GAAG,YAAY,EACrC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,MAAM,EAAE,MAAM,GAAG,MAAM,EACvB,iBAAiB,EAAE,KAAK,MAAM,EAAE,EAChC,cAAc,GAAE,MAAM,GAAG,MAAa,EACtC,OAAO,SAAM,GACZ,OAAO,CAAC,gBAAgB,CAAC;IA8Bf,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAWxD,eAAe,IAAI,kBAAkB;IAiB5C;;;OAGG;IACI,SAAS,IAAI,MAAM;IAI1B;;;OAGG;IACI,QAAQ,IAAI,MAAM;IAUzB;;;;;OAKG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC;WAYvB,OAAO,CACnB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,cAAc,EAC9B,aAAa,EAAE,OAAO,GAAG,YAAY,GACpC,gBAAgB;IAWnB;;;;OAIG;WACW,SAAS,CAAC,GAAG,EAAE,MAAM;IAInC;;;OAGG;IACI,IAAI;IAIX;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM;CAG/B"}

package/dist/models/AgentAccessToken.js

@@ -0,0 +1,164 @@
+import { decodeJwt } from 'jose';
+import { getChecksumAddress } from '../nevermined/utils/BlockchainViemUtils.js';
+import { EthSignJWT } from '../nevermined/utils/JwtUtils.js';
+import { SignatureUtils } from '../nevermined/utils/SignatureUtils.js';
+export class AgentAccessToken {
+    /**
+     * The version of the access token
+     */
+    ver;
+    /**
+     * The authorization token used to query the agent.
+     * This token is validated by the agent or proxy to ensure the request is authorized
+     * {@see {@link AgentAuthTokenParams}}
+     */
+    authToken;
+    /**
+     * The proof generated by the subscriber (sub) to prove the request to query the agent
+     * {@see {@link JWTRedemptionProofParams}
+     */
+    proof;
+    iss;
+    sub;
+    aud;
+    exp;
+    iat;
+    _signatureUtils;
+    _issuerAccount;
+    constructor(signatureUtils, issuerAccount) {
+        this.ver = '1';
+        this._signatureUtils = signatureUtils;
+        this._issuerAccount = issuerAccount;
+    }
+    /**
+     * It generates a new serialized and encrypted NvmApiKey including the ZeroDev session key and the Marketplace auth token.
+     * The string  representing this key can be used to authenticate against the Nevermined API.
+     * @param signatureUtils The SignatureUtils instance
+     * @param issuerAccount The account issuing the key
+    
+     */
+    static async generate(signatureUtils, issuerAccount, agentId, planId, subscriberAddress, expirationTime = '1y', version = '1') {
+        const issuerAddress = getChecksumAddress(issuerAccount.address);
+        const chainId = signatureUtils.client.chain?.id || 0;
+        const sub = getChecksumAddress(subscriberAddress);
+        const jwtAuth = {
+            iss: issuerAddress,
+            aud: chainId.toString(),
+            sub,
+            agentId: typeof agentId === 'bigint' ? agentId.toString() : agentId,
+            planId: typeof planId === 'bigint' ? planId.toString() : planId,
+        };
+        const signedJWTAuth = await new EthSignJWT(jwtAuth)
+            .setProtectedHeader({ alg: 'ES256K' })
+            .setIssuedAt()
+            .setExpirationTime(expirationTime)
+            .ethSign(signatureUtils, issuerAccount);
+        // const jwtAccessToken: JWTAgentAccessToken = {
+        //   ver: version,
+        //   authToken: signedJWTAuth,
+        //   proof: undefined, // This can be set later when the proof is generated
+        // }
+        const agentAccessToken = new AgentAccessToken(signatureUtils, issuerAccount);
+        agentAccessToken.ver = version;
+        agentAccessToken.authToken = signedJWTAuth;
+        agentAccessToken.proof = undefined; // This can be set later when the proof is generated
+        return agentAccessToken;
+    }
+    async setRedemptionProof(keyspace, nonce) {
+        const jwtPayload = decodeJwt(this.authToken);
+        const proofParams = {
+            keyspace,
+            nonce,
+            planIds: [String(jwtPayload.planId)],
+        };
+        this.proof = JSON.stringify(proofParams);
+        return this;
+    }
+    decodeAuthToken() {
+        if (!this.authToken) {
+            throw new Error('Auth token is not set');
+        }
+        const jwt = decodeJwt(this.authToken);
+        return {
+            agentId: jwt.agentId,
+            planId: jwt.planId,
+            sub: jwt.sub,
+            iss: jwt.iss,
+            aud: jwt.aud,
+            exp: jwt.exp,
+            iat: jwt.iat,
+        };
+    }
+    /**
+     * It serializes the NVM Api Key into a string
+     * @returns a string representing the NVM API Key
+     */
+    serialize() {
+        return this.toString();
+    }
+    /**
+     * It serializes the NVM Api Key into a string
+     * @returns a string representing the NVM API Key
+     */
+    toString() {
+        const params = {};
+        Object.keys(this)
+            .filter((val) => val !== undefined)
+            .forEach((key) => {
+            if (!key.startsWith('_'))
+                params[key] = this[key];
+        });
+        return JSON.stringify(params);
+    }
+    /**
+     * It generates a signed JWT from the NvmApiKey
+     * @param signatureUtils The SignatureUtils instance
+     * @param issuerAccount The account issuing the key
+     * @returns the string in JWT format represeting the NvmApiKey
+     */
+    async toJWT() {
+        const params = {};
+        Object.keys(this)
+            .filter((val) => val !== undefined)
+            .forEach((key) => {
+            if (!key.startsWith('_'))
+                params[key] = this[key];
+        });
+        const jwt = new EthSignJWT(params).setProtectedHeader({ alg: 'ES256K' });
+        return jwt.ethSign(this._signatureUtils, this._issuerAccount);
+    }
+    static fromJWT(jwtString, signatureUtils, issuerAddress) {
+        const jwt = AgentAccessToken.decodeJWT(jwtString);
+        const agentAccessToken = new AgentAccessToken(signatureUtils, issuerAddress);
+        Object.keys(jwt)
+            .filter((val) => val !== undefined)
+            .forEach((key) => {
+            if (!key.startsWith('_'))
+                agentAccessToken[key] = jwt[key];
+        });
+        return agentAccessToken;
+    }
+    /**
+     * It decodes a string JWT into a JWTPayload
+     * @param str jwt string
+     * @returns the JWTPayload
+     */
+    static decodeJWT(str) {
+        return decodeJwt(str);
+    }
+    /**
+     * It generates the hash of the NvmApiKey
+     * @returns a string representing the hash of the NvmApiKey
+     */
+    hash() {
+        return SignatureUtils.hash(this.serialize());
+    }
+    /**
+     * Given a serialized string, it generates the hash
+     * @param serialized the serialized string
+     * @returns the hash
+     */
+    static hash(serialized) {
+        return SignatureUtils.hash(serialized);
+    }
+}

package/dist/models/AgentX402AccessToken.d.ts

@@ -0,0 +1,59 @@
+import { PublicClient } from 'viem';
+import { SmartAccount } from 'viem/account-abstraction';
+export type AgentX402AccessToken = {
+    x402Version: number;
+    scheme: string;
+    network: string;
+    payload: {
+        signature: `0x${string}`;
+        authorization: {
+            sessionKeysProvider: string;
+            sessionKeys: {
+                id: string;
+                data: string;
+            }[];
+        };
+    };
+};
+export type NeverminedTypedDataDomain = {
+    name: 'Nevermined';
+    version: '1';
+    chainId: number;
+    verifyingContract: `0x${string}`;
+};
+export type NeverminedTypedData = {
+    SessionKey: [{
+        name: 'id';
+        type: 'string';
+    }, {
+        name: 'data';
+        type: 'string';
+    }];
+    SessionKeys: [{
+        name: 'sessionKeys';
+        type: 'SessionKey[]';
+    }];
+    Authorization: [
+        {
+            name: 'sessionKeysProvider';
+            type: 'string';
+        },
+        {
+            name: 'sessionKeys';
+            type: 'SessionKey[]';
+        }
+    ];
+};
+export declare const NeverminedTypedDataTypes: NeverminedTypedData;
+export type NeverminedTypedDataMessage = {
+    sessionKeysProvider: string;
+    sessionKeys: {
+        id: string;
+        data: string;
+    }[];
+};
+export declare const generateAgentX402AccessToken: (subscriber: SmartAccount, orderSessionKey: string, burnSessionKey: string, publicClient: PublicClient) => Promise<AgentX402AccessToken>;
+export declare const verifyAgentX402AccessToken: (accessToken: AgentX402AccessToken, publicClient: PublicClient, subscriberAddress: `0x${string}`) => Promise<boolean>;
+export declare const b64EncodeX402AccessToken: (accessToken: AgentX402AccessToken) => string;
+export declare const b64DecodeX402AccessToken: (encoded: string) => AgentX402AccessToken;
+//# sourceMappingURL=AgentX402AccessToken.d.ts.map

package/dist/models/AgentX402AccessToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentX402AccessToken.d.ts","sourceRoot":"","sources":["../../src/models/AgentX402AccessToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,YAAY,EAAgC,MAAM,MAAM,CAAA;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,MAAM,MAAM,oBAAoB,GAAG;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE;QACP,SAAS,EAAE,KAAK,MAAM,EAAE,CAAA;QACxB,aAAa,EAAE;YACb,mBAAmB,EAAE,MAAM,CAAA;YAC3B,WAAW,EAAE;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,CAAA;aAAE,EAAE,CAAA;SAC5C,CAAA;KACF,CAAA;CACF,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,GAAG,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,KAAK,MAAM,EAAE,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC,CAAA;IAC9E,WAAW,EAAE,CAAC;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,CAAA;IAC5D,aAAa,EAAE;QACb;YAAE,IAAI,EAAE,qBAAqB,CAAC;YAAC,IAAI,EAAE,QAAQ,CAAA;SAAE;QAC/C;YAAE,IAAI,EAAE,aAAa,CAAC;YAAC,IAAI,EAAE,cAAc,CAAA;SAAE;KAC9C,CAAA;CACF,CAAA;AAED,eAAO,MAAM,wBAAwB,EAAE,mBAUtC,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,mBAAmB,EAAE,MAAM,CAAA;IAC3B,WAAW,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;CAC5C,CAAA;AAED,eAAO,MAAM,4BAA4B,GACvC,YAAY,YAAY,EACxB,iBAAiB,MAAM,EACvB,gBAAgB,MAAM,EACtB,cAAc,YAAY,KACzB,OAAO,CAAC,oBAAoB,CA+C9B,CAAA;AAED,eAAO,MAAM,0BAA0B,GACrC,aAAa,oBAAoB,EACjC,cAAc,YAAY,EAC1B,mBAAmB,KAAK,MAAM,EAAE,KAC/B,OAAO,CAAC,OAAO,CAiBjB,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,aAAa,oBAAoB,KAAG,MAE5E,CAAA;AAED,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,oBAE1D,CAAA"}

package/dist/models/AgentX402AccessToken.js

@@ -0,0 +1,78 @@
+import { keccak256, toBytes } from 'viem';
+export const NeverminedTypedDataTypes = {
+    SessionKey: [
+        { name: 'id', type: 'string' },
+        { name: 'data', type: 'string' },
+    ],
+    SessionKeys: [{ name: 'sessionKeys', type: 'SessionKey[]' }],
+    Authorization: [
+        { name: 'sessionKeysProvider', type: 'string' },
+        { name: 'sessionKeys', type: 'SessionKey[]' },
+    ],
+};
+export const generateAgentX402AccessToken = async (subscriber, orderSessionKey, burnSessionKey, publicClient) => {
+    // hash the session keys
+    const burnSessionKeyHash = keccak256(toBytes(burnSessionKey));
+    const orderSessionKeyHash = keccak256(toBytes(orderSessionKey));
+    // generate the message
+    const message = {
+        sessionKeysProvider: 'zerodev',
+        sessionKeys: [
+            {
+                id: 'order',
+                data: orderSessionKeyHash,
+            },
+            {
+                id: 'redeem',
+                data: burnSessionKeyHash,
+            },
+        ],
+    };
+    const domain = {
+        name: 'Nevermined',
+        version: '1',
+        chainId: publicClient.chain?.id,
+        verifyingContract: subscriber.address,
+    };
+    // generate the eip712 data
+    const eip712Data = {
+        domain,
+        types: NeverminedTypedDataTypes,
+        primaryType: 'Authorization',
+        message,
+    };
+    const signature = await subscriber.signTypedData(eip712Data);
+    return {
+        x402Version: 2,
+        scheme: 'contract',
+        network: publicClient.chain?.name,
+        payload: {
+            signature,
+            authorization: message,
+        },
+    };
+};
+export const verifyAgentX402AccessToken = async (accessToken, publicClient, subscriberAddress) => {
+    const domain = {
+        name: 'Nevermined',
+        version: '1',
+        chainId: publicClient.chain?.id,
+        verifyingContract: subscriberAddress,
+    };
+    const { signature, authorization } = accessToken.payload;
+    const isValid = await publicClient.verifyTypedData({
+        address: subscriberAddress,
+        signature,
+        types: NeverminedTypedDataTypes,
+        domain,
+        message: authorization,
+        primaryType: 'Authorization',
+    });
+    return isValid;
+};
+export const b64EncodeX402AccessToken = (accessToken) => {
+    return Buffer.from(JSON.stringify(accessToken)).toString('base64');
+};
+export const b64DecodeX402AccessToken = (encoded) => {
+    return JSON.parse(Buffer.from(encoded, 'base64').toString('utf-8'));
+};

package/dist/models/Logger.d.ts

@@ -0,0 +1,9 @@
+import { Logger as PinoLogger } from 'pino';
+export type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace' | 'silent';
+export interface LoggerConfig {
+    level?: LogLevel;
+    pretty?: boolean;
+}
+export declare const createLogger: (config?: LoggerConfig) => PinoLogger<never, boolean>;
+export declare const LoggerInstance: () => PinoLogger;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/models/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/models/Logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAA;AAEjD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEzF,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAID,eAAO,MAAM,YAAY,GAAI,SAAQ,YAAiB,+BAgBrD,CAAA;AAED,eAAO,MAAM,cAAc,kBAQ1B,CAAA"}

package/dist/models/Logger.js

@@ -0,0 +1,27 @@
+import { pino } from 'pino';
+let loggerInstance;
+export const createLogger = (config = {}) => {
+    const { level = 'info', pretty = false } = config;
+    return pino({
+        level,
+        transport: pretty
+            ? {
+                target: 'pino-pretty',
+                options: {
+                    colorize: true,
+                    translateTime: 'HH:MM:ss',
+                    ignore: 'pid,hostname',
+                },
+            }
+            : undefined,
+    });
+};
+export const LoggerInstance = () => {
+    if (!loggerInstance) {
+        loggerInstance = createLogger({
+            level: 'debug',
+            pretty: true,
+        });
+    }
+    return loggerInstance;
+};

package/dist/models/NeverminedOptions.d.ts

@@ -0,0 +1,30 @@
+import { Account } from 'viem';
+export declare class NeverminedOptions {
+    chainId: number;
+    /**
+     * Ethereum Web3 Provider URL. This Url allows the SDK to connect to a blockchain.
+     * This provider depends on the network where you want to connect (Ethereum Mainnet, Rinkeby, Polygon Matic, etc).
+     * It's possible to use a public available provider or a private/paid one like Infura, Alchemy, etc.
+     */
+    web3ProviderUri?: string;
+    /**
+     * The Nevermined App URL.
+     */
+    appUrl?: string;
+    backendUrl?: string;
+    agentsProxy?: string;
+    /**
+     * Log level.
+     */
+    logLevel: string;
+    accounts?: Account[];
+    /**
+     * ZeroDev project id
+     */
+    zeroDevProjectId?: string;
+    /**
+     * Contracts version
+     */
+    contractsVersion?: string;
+}
+//# sourceMappingURL=NeverminedOptions.d.ts.map

package/dist/models/NeverminedOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NeverminedOptions.d.ts","sourceRoot":"","sources":["../../src/models/NeverminedOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAE9B,qBAAa,iBAAiB;IACrB,OAAO,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACI,eAAe,CAAC,EAAE,MAAM,CAAA;IAE/B;;OAEG;IACI,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,WAAW,CAAC,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACI,QAAQ,SAAS;IAEjB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAA;IAE3B;;OAEG;IACI,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAEhC;;OAEG;IACI,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACjC"}