@t-0/provider-sdk 1.0.19

package/README.md

@@ -0,0 +1,24 @@
+## Usage instructions
+Usage instruction can be found in [NodeJS SDK docs](https://t-0-network.github.io/docs/integration-guidance/sdk-integration/ts-sdk/)
+
+## Development instructions
+1. Prepare
+    ```bash
+    git clone git@github.com:t-0-network/provider-sdk-ts.git
+    cd provider-sdk-ts
+    npm i
+    ```
+2. Copy `.env.example` into `.env` and set PROVIDER_PRIVATE_KEY and NETWORK_PUBLIC_KEY variables
+    ```dotenv
+    PROVIDER_PRIVATE_KEY=0x....
+    NETWORK_PUBLIC_KEY=0x....
+    
+    ```
+3. Try using network client 
+    ```bash
+    npx tsx examples/update-quote.ts
+    ```
+4. Start dummy service implementation
+    ```bash
+    npx tsx examples/server.ts
+    ```

package/lib/client/client.d.ts

@@ -0,0 +1,46 @@
+export declare const DEFAULT_ENDPOINT = "https://api.t-0.network";
+export declare function createNetworkClient(signer: string | Buffer | SignerFunction, endpoint?: string): import("@connectrpc/connect").Client<import("@bufbuild/protobuf/codegenv2").GenService<{
+    updateQuote: {
+        methodKind: "unary";
+        input: typeof import("../common/gen/network/network_pb").UpdateQuoteRequestSchema;
+        output: typeof import("../common/gen/network/network_pb").UpdateQuoteResponseSchema;
+    };
+    getPayoutQuote: {
+        methodKind: "unary";
+        input: typeof import("../common/gen/network/network_pb").GetPayoutQuoteRequestSchema;
+        output: typeof import("../common/gen/network/network_pb").GetPayoutQuoteResponseSchema;
+    };
+    createPayment: {
+        methodKind: "unary";
+        input: typeof import("../common/gen/network/network_pb").CreatePaymentRequestSchema;
+        output: typeof import("../common/gen/network/network_pb").CreatePaymentResponseSchema;
+    };
+    updatePayout: {
+        methodKind: "unary";
+        input: typeof import("../common/gen/network/network_pb").UpdatePayoutRequestSchema;
+        output: typeof import("../common/gen/network/network_pb").UpdatePayoutResponseSchema;
+    };
+    createPayIn: {
+        methodKind: "unary";
+        input: typeof import("../common/gen/network/network_pb").CreatePayInRequestSchema;
+        output: typeof import("../common/gen/network/network_pb").CreatePayInResponseSchema;
+    };
+    getKycData: {
+        methodKind: "unary";
+        input: typeof import("../common/gen/network/network_pb").GetKycDataRequestSchema;
+        output: typeof import("../common/gen/network/network_pb").GetKycDataResponseSchema;
+    };
+}>>;
+/**
+ * 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 createNetworkClient;

package/lib/client/client.js

@@ -0,0 +1,40 @@
+import { createClient } from "@connectrpc/connect";
+import { createConnectTransport } from "@connectrpc/connect-web";
+import { keccak_256 } from "@noble/hashes/sha3";
+import { NetworkService } from "../common/gen/network/network_pb";
+import CreateSigner from "./signer";
+import NetworkHeaders from "../common/headers";
+export const DEFAULT_ENDPOINT = "https://api.t-0.network";
+export function createNetworkClient(signer, endpoint) {
+    let customFetch;
+    endpoint = endpoint || DEFAULT_ENDPOINT;
+    if (typeof signer === "string" || Buffer.isBuffer(signer)) {
+        signer = CreateSigner(signer);
+    }
+    customFetch = async (r, init) => {
+        if (!init?.body || !((init.body) instanceof Uint8Array)) {
+            throw "unsupported body type";
+        }
+        const ts = Date.now();
+        // 64‑bit little‑endian timestamp
+        const tsBuf = Buffer.alloc(8);
+        tsBuf.writeBigUInt64LE(BigInt(ts));
+        const hash = keccak_256.create()
+            .update(init.body)
+            .update(tsBuf);
+        const hashHex = Buffer.from(hash.digest());
+        const sig = await signer(hashHex);
+        const headers = new Headers(init?.headers);
+        headers.append(NetworkHeaders.Signature, "0x" + sig.signature.toString('hex'));
+        headers.append(NetworkHeaders.PublicKey, "0x" + sig.publicKey.toString('hex'));
+        headers.append(NetworkHeaders.SignatureTimestamp, ts.toString());
+        const modifiedInit = { ...init, headers };
+        return fetch(r, modifiedInit);
+    };
+    const transport = createConnectTransport({
+        baseUrl: endpoint || DEFAULT_ENDPOINT,
+        fetch: customFetch,
+    });
+    return createClient(NetworkService, transport);
+}
+export default createNetworkClient;

package/lib/client/signer.d.ts

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

package/lib/client/signer.js

@@ -0,0 +1,32 @@
+import * as secp from '@noble/secp256k1';
+export const CreateSigner = (privateKey) => {
+    privateKey = parsePrivateKey(privateKey);
+    const publicKey = Buffer.from(secp.getPublicKey(privateKey, false));
+    return async (data) => {
+        // Ensure hash is 32 bytes
+        if (data.length !== 32) {
+            throw new Error('Message hash must be 32 bytes');
+        }
+        // Sign the hash
+        const signature = await secp.signAsync(data, privateKey);
+        return {
+            signature: Buffer.from(signature.toBytes()),
+            publicKey: publicKey,
+        };
+    };
+};
+const parsePrivateKey = (privateKey) => {
+    if (typeof privateKey == 'string') {
+        privateKey = privateKey.replace(/^0x/, '');
+        if (!/^[0-9a-fA-F]{64}$/.test(privateKey)) {
+            throw new Error('Private key must be 64 hex characters');
+        }
+        privateKey = Buffer.from(privateKey, 'hex');
+    }
+    // Validate private key
+    if (!secp.utils.isValidPrivateKey(privateKey)) {
+        throw new Error('Invalid private key');
+    }
+    return privateKey;
+};
+export default CreateSigner;

package/lib/common/gen/common/common_pb.d.ts

@@ -0,0 +1,26 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file common/common.proto.
+ */
+export declare const file_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>;

package/lib/common/gen/common/common_pb.js

@@ -0,0 +1,13 @@
+// @generated by protoc-gen-es v2.6.0 with parameter "target=ts"
+// @generated from file common/common.proto (package tzero.v1.common, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Describes the file common/common.proto.
+ */
+export const file_common_common = /*@__PURE__*/ fileDesc("ChNjb21tb24vY29tbW9uLnByb3RvEg90emVyby52MS5jb21tb24iLQoHRGVjaW1hbBIQCgh1bnNjYWxlZBgKIAEoAxIQCghleHBvbmVudBgUIAEoBUKAAQoTY29tLnR6ZXJvLnYxLmNvbW1vbkILQ29tbW9uUHJvdG9QAaICA1RWQ6oCD1R6ZXJvLlYxLkNvbW1vbsoCD1R6ZXJvXFYxXENvbW1vbuICG1R6ZXJvXFYxXENvbW1vblxHUEJNZXRhZGF0YeoCEVR6ZXJvOjpWMTo6Q29tbW9uYgZwcm90bzM");
+/**
+ * Describes the message tzero.v1.common.Decimal.
+ * Use `create(DecimalSchema)` to create a new message.
+ */
+export const DecimalSchema = /*@__PURE__*/ messageDesc(file_common_common, 0);

package/lib/common/gen/common/payment_method_pb.d.ts

@@ -0,0 +1,51 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file common/payment_method.proto.
+ */
+export declare const file_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";
+    } | {
+        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 = 10;
+     */
+    iban: string;
+    /**
+     * @generated from field: string payment_reference = 20;
+     */
+    paymentReference: string;
+    /**
+     * @generated from field: string name = 30;
+     */
+    name: string;
+};
+/**
+ * Describes the message tzero.v1.common.SepaPaymentMethod.
+ * Use `create(SepaPaymentMethodSchema)` to create a new message.
+ */
+export declare const SepaPaymentMethodSchema: GenMessage<SepaPaymentMethod>;

package/lib/common/gen/common/payment_method_pb.js

@@ -0,0 +1,18 @@
+// @generated by protoc-gen-es v2.6.0 with parameter "target=ts"
+// @generated from file common/payment_method.proto (package tzero.v1.common, syntax proto3)
+/* eslint-disable */
+import { fileDesc, messageDesc } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Describes the file common/payment_method.proto.
+ */
+export const file_common_payment_method = /*@__PURE__*/ fileDesc("Chtjb21tb24vcGF5bWVudF9tZXRob2QucHJvdG8SD3R6ZXJvLnYxLmNvbW1vbiJOCg1QYXltZW50TWV0aG9kEjIKBHNlcGEYCiABKAsyIi50emVyby52MS5jb21tb24uU2VwYVBheW1lbnRNZXRob2RIAEIJCgdkZXRhaWxzIkoKEVNlcGFQYXltZW50TWV0aG9kEgwKBGliYW4YCiABKAkSGQoRcGF5bWVudF9yZWZlcmVuY2UYFCABKAkSDAoEbmFtZRgeIAEoCUKHAQoTY29tLnR6ZXJvLnYxLmNvbW1vbkISUGF5bWVudE1ldGhvZFByb3RvUAGiAgNUVkOqAg9UemVyby5WMS5Db21tb27KAg9UemVyb1xWMVxDb21tb27iAhtUemVyb1xWMVxDb21tb25cR1BCTWV0YWRhdGHqAhFUemVybzo6VjE6OkNvbW1vbmIGcHJvdG8z");
+/**
+ * Describes the message tzero.v1.common.PaymentMethod.
+ * Use `create(PaymentMethodSchema)` to create a new message.
+ */
+export const PaymentMethodSchema = /*@__PURE__*/ messageDesc(file_common_payment_method, 0);
+/**
+ * Describes the message tzero.v1.common.SepaPaymentMethod.
+ * Use `create(SepaPaymentMethodSchema)` to create a new message.
+ */
+export const SepaPaymentMethodSchema = /*@__PURE__*/ messageDesc(file_common_payment_method, 1);