@trepaorg/trepa-client 0.3.0

package/README.md

@@ -0,0 +1,37 @@
+# @trepaorg/client
+
+Node.js client for the Trepa API. 
+
+## Installation
+
+```bash
+pnpm add @trepaorg/client
+```
+
+npm and yarn are also supported. No `.npmrc` or registry config required.
+
+## Usage
+
+```ts
+import { createClient } from "@trepaorg/client";
+
+const client = await createClient(process.env.TREPA_API_URL, process.env.TREPA_API_KEY);
+
+
+const pools = await client.getPools();
+const pool = await client.getPool(pools[0].id);
+
+// Create and submit a prediction (sign with your wallet, then submit)
+const { transaction, proof } = await client.createPrediction({
+  pool_id: pool.id,
+  stake: 1.0,
+  value: 50_000,
+});
+
+// ... sign transaction with @solana/web3.js, then:
+await client.submitPrediction({
+  pool_id: pool.id,
+  signed_transaction: serializedTx,
+  proof,
+});
+```

package/dist/client.d.ts

@@ -0,0 +1,100 @@
+export interface TransactionProof {
+    transaction: string;
+    proof: string;
+}
+export interface SignatureResponse {
+    signature: string;
+}
+export interface SubmitClaimResponse {
+    signature: string;
+    reward: object;
+}
+export interface CreatePredictionBody {
+    pool_id: string;
+    stake: number;
+    value: number;
+}
+export interface SubmitPredictionBody {
+    pool_id: string;
+    signed_transaction: string;
+    proof: string;
+}
+export interface CreateUpdatePredictionBody {
+    prediction_id: string;
+    value: number;
+}
+export interface SubmitUpdatePredictionBody {
+    prediction_id: string;
+    signed_transaction: string;
+    proof: string;
+}
+export interface CreateUpdateStakeBody {
+    prediction_id: string;
+    stake: number;
+}
+export interface SubmitUpdateStakeBody {
+    prediction_id: string;
+    signed_transaction: string;
+    proof: string;
+}
+export interface CreateClaimBody {
+    pool_id: string;
+}
+export interface SubmitClaimBody {
+    reward_id: string;
+    signed_transaction: string;
+    proof: string;
+}
+export interface CreateWithdrawBody {
+    to_address: string;
+    amount: number;
+    mint_address: string;
+}
+export interface SubmitWithdrawBody {
+    signed_transaction: string;
+    proof: string;
+}
+export interface Pool {
+    id: string;
+    title: string;
+    pool_account: string;
+    [key: string]: unknown;
+}
+export interface GetPoolsParams {
+    filter_by?: string[];
+    sort_by?: string;
+    tag_id?: string;
+    query?: string;
+    limit?: number;
+    offset?: number;
+    includes?: string[];
+}
+export interface GetPoolParams {
+    includes?: string[];
+}
+export interface GetUserPredictionsParams {
+    filter_by?: string[];
+    sort_by?: string;
+    query?: string;
+    limit?: number;
+    offset?: number;
+    includes?: string[];
+}
+export interface Client {
+    refreshSession(): Promise<void>;
+    getPools(params?: GetPoolsParams): Promise<Pool[]>;
+    getPool(id: string, params?: GetPoolParams): Promise<Pool>;
+    getUserPredictions(userId: string, params?: GetUserPredictionsParams): Promise<unknown[]>;
+    createPrediction(body: CreatePredictionBody): Promise<TransactionProof>;
+    submitPrediction(body: SubmitPredictionBody): Promise<SignatureResponse>;
+    createUpdatePrediction(body: CreateUpdatePredictionBody): Promise<TransactionProof>;
+    submitUpdatePrediction(body: SubmitUpdatePredictionBody): Promise<SignatureResponse>;
+    createUpdateStake(body: CreateUpdateStakeBody): Promise<TransactionProof>;
+    submitUpdateStake(body: SubmitUpdateStakeBody): Promise<SignatureResponse>;
+    createClaim(body: CreateClaimBody): Promise<TransactionProof>;
+    submitClaim(body: SubmitClaimBody): Promise<SubmitClaimResponse>;
+    createWithdraw(body: CreateWithdrawBody): Promise<TransactionProof>;
+    submitWithdraw(body: SubmitWithdrawBody): Promise<SignatureResponse>;
+}
+export declare function createClient(baseURL: string | undefined, apiKey: string | undefined): Promise<Client>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,76 @@
+import axios from "axios";
+export async function createClient(baseURL, apiKey) {
+    if (!baseURL || !apiKey) {
+        throw new Error("Missing baseURL or apiKey");
+    }
+    const sessionRes = await axios.post(`${baseURL}/auth/session`, null, {
+        headers: { "trepa-api-key": apiKey },
+    });
+    const cookie = sessionRes.headers["set-cookie"];
+    const api = axios.create({
+        baseURL,
+        headers: {
+            Cookie: Array.isArray(cookie) ? cookie.join("; ") : (cookie ?? ""),
+        },
+    });
+    return {
+        async refreshSession() {
+            await api.post("/auth/session", null, {
+                headers: { "trepa-api-key": apiKey },
+            });
+        },
+        async getPools(params) {
+            const { data } = await api.get("/pools", { params });
+            return data;
+        },
+        async getPool(id, params) {
+            const { data } = await api.get(`/pools/${id}`, { params });
+            return data;
+        },
+        async getUserPredictions(userId, params) {
+            const { data } = await api.get(`/users/${userId}/predictions`, { params });
+            return data;
+        },
+        async createPrediction(body) {
+            const { data } = await api.post("/transactions/prediction", body);
+            return data;
+        },
+        async submitPrediction(body) {
+            const { data } = await api.post("/transactions/prediction/submit", body);
+            return data;
+        },
+        async createUpdatePrediction(body) {
+            const { data } = await api.post("/transactions/prediction/update", body);
+            return data;
+        },
+        async submitUpdatePrediction(body) {
+            const { data } = await api.post("/transactions/prediction/update/submit", body);
+            return data;
+        },
+        async createUpdateStake(body) {
+            const { data } = await api.post("/transactions/stake/update", body);
+            return data;
+        },
+        async submitUpdateStake(body) {
+            const { data } = await api.post("/transactions/stake/update/submit", body);
+            return data;
+        },
+        async createClaim(body) {
+            const { data } = await api.post("/transactions/claim-reward", body);
+            return data;
+        },
+        async submitClaim(body) {
+            const { data } = await api.post("/transactions/claim-reward/submit", body);
+            return data;
+        },
+        async createWithdraw(body) {
+            const { data } = await api.post("/transactions/withdraw", body);
+            return data;
+        },
+        async submitWithdraw(body) {
+            const { data } = await api.post("/transactions/withdraw/submit", body);
+            return data;
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAA6B,MAAM,OAAO,CAAC;AA6HlD,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAA2B,EAC3B,MAA0B;IAE1B,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,eAAe,EAAE,IAAI,EAAE;QACnE,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;KACrC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD,MAAM,GAAG,GAAkB,KAAK,CAAC,MAAM,CAAC;QACtC,OAAO;QACP,OAAO,EAAE;YACP,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;SACnE;KACF,CAAC,CAAC;IAEH,OAAO;QACL,KAAK,CAAC,cAAc;YAClB,MAAM,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE;gBACpC,OAAO,EAAE,EAAE,eAAe,EAAE,MAAM,EAAE;aACrC,CAAC,CAAC;QACL,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,MAAuB;YACpC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAAS,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,EAAU,EAAE,MAAsB;YAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAAO,UAAU,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YACjE,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,kBAAkB,CACtB,MAAc,EACd,MAAiC;YAEjC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,GAAG,CAC5B,UAAU,MAAM,cAAc,EAC9B,EAAE,MAAM,EAAE,CACX,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,gBAAgB,CACpB,IAA0B;YAE1B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,0BAA0B,EAC1B,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,gBAAgB,CACpB,IAA0B;YAE1B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,iCAAiC,EACjC,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,sBAAsB,CAC1B,IAAgC;YAEhC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,iCAAiC,EACjC,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,sBAAsB,CAC1B,IAAgC;YAEhC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,wCAAwC,EACxC,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,iBAAiB,CACrB,IAA2B;YAE3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,4BAA4B,EAC5B,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,iBAAiB,CACrB,IAA2B;YAE3B,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,mCAAmC,EACnC,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,IAAqB;YACrC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,4BAA4B,EAC5B,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,IAAqB;YACrC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,mCAAmC,EACnC,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,IAAwB;YAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,wBAAwB,EACxB,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,IAAwB;YAC3C,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,GAAG,CAAC,IAAI,CAC7B,+BAA+B,EAC/B,IAAI,CACL,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@trepaorg/trepa-client",
+  "version": "0.3.0",
+  "description": "Client for Trepa bot integration",
+  "type": "module",
+  "main": "dist/client.js",
+  "types": "dist/client.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@solana/web3.js": "^1.98.2",
+    "axios": "^1.7.9",
+    "bs58": "^6.0.0",
+    "dotenv": "^16.4.5"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "tsx watch examples/main.ts",
+    "start": "tsx examples/main.ts",
+    "build": "tsc"
+  }
+}