@t-0/provider-sdk 1.0.25 → 1.0.26

package/lib/cjs/service/node.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signatureValidation = void 0;
+const sha3_1 = require("@noble/hashes/sha3");
+const signatureValidation = (next) => (req, resp) => {
+    const hasher = sha3_1.keccak_256.create();
+    req.hasher = hasher;
+    req.on("data", (chunk) => {
+        if (chunk instanceof Buffer) {
+            hasher.update(chunk);
+        }
+    });
+    next(req, resp);
+};
+exports.signatureValidation = signatureValidation;

package/lib/cjs/service/service.js

@@ -0,0 +1,112 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createService = exports.REQUEST_VALIDITY_MILLIS = void 0;
+const connect_1 = require("@connectrpc/connect");
+const headers_js_1 = __importDefault(require("../common/headers.js"));
+const secp = __importStar(require("@noble/secp256k1"));
+exports.REQUEST_VALIDITY_MILLIS = 60000;
+const createSignatureVerification = (networkPublicKey) => (next) => async (req) => {
+    const ts = decodeNum(getHeader(req, headers_js_1.default.SignatureTimestamp));
+    if (Date.now() - ts > 60000) {
+        throw new connect_1.ConnectError(`${headers_js_1.default.SignatureTimestamp} must be within ${exports.REQUEST_VALIDITY_MILLIS} milliseconds from now`, connect_1.Code.InvalidArgument);
+    }
+    const publicKey = decodeHex(getHeader(req, headers_js_1.default.PublicKey));
+    if (networkPublicKey.compare(publicKey) !== 0) {
+        throw new connect_1.ConnectError(`${headers_js_1.default.PublicKey} value is not network public key`, connect_1.Code.Unauthenticated);
+    }
+    const signature = decodeHex(getHeader(req, headers_js_1.default.Signature));
+    const hasher = req.contextValues.get(kHash);
+    const tsBuf = Buffer.alloc(8);
+    tsBuf.writeBigUInt64LE(BigInt(ts)); // 64‑bit little‑endian timestamp
+    const hash = hasher
+        .update(tsBuf)
+        .digest();
+    let signatureValid = false;
+    try {
+        signatureValid = secp.verify(signature, hash, publicKey);
+    }
+    catch (e) {
+        throw new connect_1.ConnectError(`${headers_js_1.default.Signature} has invalid signature or public key format`, connect_1.Code.Unauthenticated);
+    }
+    if (!signatureValid) {
+        throw new connect_1.ConnectError(`${headers_js_1.default.Signature} has invalid signature`, connect_1.Code.Unauthenticated);
+    }
+    return await next(req);
+};
+const createService = (networkPublicKey, registerRoutes) => {
+    if (typeof networkPublicKey == "string") {
+        networkPublicKey = decodeHex(networkPublicKey);
+    }
+    return {
+        routes: (router) => {
+            registerRoutes(router);
+        },
+        interceptors: [createSignatureVerification(networkPublicKey)],
+        grpcWeb: false,
+        contextValues: (req) => {
+            return (0, connect_1.createContextValues)().set(kHash, req.hasher);
+        }
+    };
+};
+exports.createService = createService;
+const kHash = (0, connect_1.createContextKey)(undefined);
+function getHeader(req, header) {
+    const raw = req.header.get(header);
+    if (!raw) {
+        throw new connect_1.ConnectError(`missing required header '${header}'`, connect_1.Code.InvalidArgument);
+    }
+    return raw;
+}
+function decodeHex(value) {
+    value = value.startsWith('0x') ? value.slice(2) : value;
+    try {
+        return Buffer.from(value, "hex");
+    }
+    catch (e) {
+        throw new connect_1.ConnectError(`invalid header format. '${value}' must be hex encoded`, connect_1.Code.InvalidArgument);
+    }
+}
+function decodeNum(value) {
+    try {
+        return parseInt(value);
+    }
+    catch (e) {
+        throw new connect_1.ConnectError(`invalid header format. '${value}' must be a number`, connect_1.Code.InvalidArgument);
+    }
+}

package/lib/esm/client/client.d.ts

@@ -0,0 +1,16 @@
+import { DescService } from "@bufbuild/protobuf";
+export declare const DEFAULT_ENDPOINT = "https://api.t-0.network";
+export declare function createClient<T extends DescService>(signer: string | Buffer | ((data: Buffer) => Promise<Signature>) | Buffer<ArrayBufferLike>, endpoint: string | undefined, svc: T): import("@connectrpc/connect").Client<T>;
+/**
+ * Signature with metadata for particular request
+ */
+export interface Signature {
+    signature: Buffer;
+    publicKey: Buffer;
+}
+/**
+ * Signature function for signing requests to T-0 API. Accepts any data in string format and return signature
+ * with metadata
+ */
+export type SignerFunction = (data: Buffer) => Promise<Signature>;
+export default createClient;

package/lib/esm/client/signer.d.ts

@@ -0,0 +1,3 @@
+import { Signature } from "./client.js";
+export declare const CreateSigner: (privateKey: string | Buffer) => (data: Buffer) => Promise<Signature>;
+export default CreateSigner;

package/lib/esm/common/gen/tzero/v1/common/common_pb.d.ts

@@ -0,0 +1,64 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file tzero/v1/common/common.proto.
+ */
+export declare const file_tzero_v1_common_common: GenFile;
+/**
+ * Decimal 123.45 equals to unscaled=12345 and exponent=-2 (e.g. unscaled * 10^exponent, 123.45 = 12345 * 10^-2)
+ *
+ * @generated from message tzero.v1.common.Decimal
+ */
+export type Decimal = Message<"tzero.v1.common.Decimal"> & {
+    /**
+     * @generated from field: int64 unscaled = 10;
+     */
+    unscaled: bigint;
+    /**
+     * @generated from field: int32 exponent = 20;
+     */
+    exponent: number;
+};
+/**
+ * Describes the message tzero.v1.common.Decimal.
+ * Use `create(DecimalSchema)` to create a new message.
+ */
+export declare const DecimalSchema: GenMessage<Decimal>;
+/**
+ * @generated from enum tzero.v1.common.Blockchain
+ */
+export declare enum Blockchain {
+    /**
+     * @generated from enum value: BLOCKCHAIN_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: BLOCKCHAIN_BSC = 10;
+     */
+    BSC = 10,
+    /**
+     * @generated from enum value: BLOCKCHAIN_TRON = 100;
+     */
+    TRON = 100
+}
+/**
+ * Describes the enum tzero.v1.common.Blockchain.
+ */
+export declare const BlockchainSchema: GenEnum<Blockchain>;
+/**
+ * @generated from enum tzero.v1.common.Stablecoin
+ */
+export declare enum Stablecoin {
+    /**
+     * @generated from enum value: STABLECOIN_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: STABLECOIN_USDT = 10;
+     */
+    USDT = 10
+}
+/**
+ * Describes the enum tzero.v1.common.Stablecoin.
+ */
+export declare const StablecoinSchema: GenEnum<Stablecoin>;

package/lib/esm/common/gen/tzero/v1/common/payment_method_pb.d.ts

@@ -0,0 +1,122 @@
+import type { GenEnum, GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Blockchain, Stablecoin } from "./common_pb.js";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file tzero/v1/common/payment_method.proto.
+ */
+export declare const file_tzero_v1_common_payment_method: GenFile;
+/**
+ * @generated from message tzero.v1.common.PaymentMethod
+ */
+export type PaymentMethod = Message<"tzero.v1.common.PaymentMethod"> & {
+    /**
+     * @generated from oneof tzero.v1.common.PaymentMethod.details
+     */
+    details: {
+        /**
+         * @generated from field: tzero.v1.common.SepaPaymentMethod sepa = 10;
+         */
+        value: SepaPaymentMethod;
+        case: "sepa";
+    } | {
+        /**
+         * @generated from field: tzero.v1.common.SwiftPaymentMethod swift = 30;
+         */
+        value: SwiftPaymentMethod;
+        case: "swift";
+    } | {
+        /**
+         * @generated from field: tzero.v1.common.StablecoinPaymentMethod stablecoin = 40;
+         */
+        value: StablecoinPaymentMethod;
+        case: "stablecoin";
+    } | {
+        case: undefined;
+        value?: undefined;
+    };
+};
+/**
+ * Describes the message tzero.v1.common.PaymentMethod.
+ * Use `create(PaymentMethodSchema)` to create a new message.
+ */
+export declare const PaymentMethodSchema: GenMessage<PaymentMethod>;
+/**
+ * @generated from message tzero.v1.common.SepaPaymentMethod
+ */
+export type SepaPaymentMethod = Message<"tzero.v1.common.SepaPaymentMethod"> & {
+    /**
+     * @generated from field: string iban = 20;
+     */
+    iban: string;
+    /**
+     * @generated from field: string beneficiary_name = 30;
+     */
+    beneficiaryName: string;
+    /**
+     * @generated from field: string payment_reference = 40;
+     */
+    paymentReference: string;
+};
+/**
+ * Describes the message tzero.v1.common.SepaPaymentMethod.
+ * Use `create(SepaPaymentMethodSchema)` to create a new message.
+ */
+export declare const SepaPaymentMethodSchema: GenMessage<SepaPaymentMethod>;
+/**
+ * @generated from message tzero.v1.common.SwiftPaymentMethod
+ */
+export type SwiftPaymentMethod = Message<"tzero.v1.common.SwiftPaymentMethod"> & {};
+/**
+ * Describes the message tzero.v1.common.SwiftPaymentMethod.
+ * Use `create(SwiftPaymentMethodSchema)` to create a new message.
+ */
+export declare const SwiftPaymentMethodSchema: GenMessage<SwiftPaymentMethod>;
+/**
+ * @generated from message tzero.v1.common.StablecoinPaymentMethod
+ */
+export type StablecoinPaymentMethod = Message<"tzero.v1.common.StablecoinPaymentMethod"> & {
+    /**
+     * @generated from field: tzero.v1.common.Blockchain blockchain = 10;
+     */
+    blockchain: Blockchain;
+    /**
+     * @generated from field: tzero.v1.common.Stablecoin stablecoin = 20;
+     */
+    stablecoin: Stablecoin;
+    /**
+     * @generated from field: string address = 30;
+     */
+    address: string;
+};
+/**
+ * Describes the message tzero.v1.common.StablecoinPaymentMethod.
+ * Use `create(StablecoinPaymentMethodSchema)` to create a new message.
+ */
+export declare const StablecoinPaymentMethodSchema: GenMessage<StablecoinPaymentMethod>;
+/**
+ * @generated from enum tzero.v1.common.PaymentMethodType
+ */
+export declare enum PaymentMethodType {
+    /**
+     * @generated from enum value: PAYMENT_METHOD_TYPE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: PAYMENT_METHOD_TYPE_SEPA = 10;
+     */
+    SEPA = 10,
+    /**
+     * @generated from enum value: PAYMENT_METHOD_TYPE_SWIFT = 20;
+     */
+    SWIFT = 20,
+    /**
+     * only pay in
+     *
+     * @generated from enum value: PAYMENT_METHOD_TYPE_CARD = 30;
+     */
+    CARD = 30
+}
+/**
+ * Describes the enum tzero.v1.common.PaymentMethodType.
+ */
+export declare const PaymentMethodTypeSchema: GenEnum<PaymentMethodType>;