@chainstream-io/sdk 0.0.1

package/dist/src/openapi/util.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canConsumeForm = exports.isCodeInRange = void 0;
+function isCodeInRange(codeRange, code) {
+    if (codeRange === "0") {
+        return true;
+    }
+    if (codeRange == code.toString()) {
+        return true;
+    }
+    else {
+        const codeString = code.toString();
+        if (codeString.length != codeRange.length) {
+            return false;
+        }
+        for (let i = 0; i < codeString.length; i++) {
+            if (codeRange.charAt(i) != "X" && codeRange.charAt(i) != codeString.charAt(i)) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
+exports.isCodeInRange = isCodeInRange;
+function canConsumeForm(contentTypes) {
+    return contentTypes.indexOf('multipart/form-data') !== -1;
+}
+exports.canConsumeForm = canConsumeForm;
+//# sourceMappingURL=util.js.map

package/dist/src/openapi/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/openapi/util.ts"],"names":[],"mappings":";;;AAQA,SAAgB,aAAa,CAAC,SAAiB,EAAE,IAAY;IAEzD,IAAI,SAAS,KAAK,GAAG,EAAE;QACnB,OAAO,IAAI,CAAC;KACf;IACD,IAAI,SAAS,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE;QAC9B,OAAO,IAAI,CAAC;KACf;SAAM;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE;YACvC,OAAO,KAAK,CAAC;SAChB;QACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;YACxC,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;gBAC3E,OAAO,KAAK,CAAC;aAChB;SACJ;QACD,OAAO,IAAI,CAAC;KACf;AACL,CAAC;AAnBD,sCAmBC;AAOD,SAAgB,cAAc,CAAC,YAAsB;IACjD,OAAO,YAAY,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAA;AAC7D,CAAC;AAFD,wCAEC"}

package/dist/stream.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/stream.test.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const stream_model_1 = require("./src/api/stream.model");
+const src_1 = require("./src");
+(0, globals_1.describe)('StreamApi Connection Test', () => {
+    let streamApi;
+    (0, globals_1.beforeEach)(() => {
+        const context = {
+            baseUrl: "https://api-dex.chainstream.io/",
+            streamUrl: "wss://realtime-dex.chainstream.io/connection/websocket",
+            accessToken: "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImtleXN0b3JlLUNIQU5HRS1NRSJ9.eyJqdGkiOiIwLTBRZENBQURWTWlWOEp6OUc1bmsiLCJzdWIiOiJIR2hWbmpiSWlheDFIcDNUakdUd083WU9FUkJURXRwaSIsImlhdCI6MTc1NjU3OTAwMywiZXhwIjoxNzU2NjY1NDAzLCJjbGllbnRfaWQiOiJIR2hWbmpiSWlheDFIcDNUakdUd083WU9FUkJURXRwaSIsImlzcyI6Imh0dHBzOi8vZGV4LmFzaWEuYXV0aC5jaGFpbnN0cmVhbS5pby8iLCJhdWQiOiJodHRwczovL2FwaS5kZXguY2hhaW5zdHJlYW0uaW8ifQ.EUebhXoS8R_KIX4QWnCq5u5ANQa4XDOG0_u_Ucdt6xTA55pa-lX2dPf37Yb1OjyVcVEV4PMrRX5-ddYfVPDR0mAajyp_689v58cA8AL1mrdXQEpo1WM-nr9CXbPxzBkHk58hQ_7mzGqOy9oFu6ffWr7HsPT3jSw6wsc88kO1c9mvGA8A6uPxTGx6cON2ZK9hOm3NLD1bpPrIY6UPAg7T-QkkEHQWRpbYd0DKzxJFxjtooM21_s_TMdcz8FeazNuJnslGU0vTxt5yp-FjW8kgYtEb3S2c08flV5Qf8Kc4nQKdJvbl9XiLy6uLJ7iFU3Vc_1gao6Dvjrj2trxYWpo0jA"
+        };
+        streamApi = new src_1.DexClient(context.accessToken).stream;
+        streamApi["realtimeClient"].on("connecting", () => {
+            console.log("🔄 Connecting to websocket server...");
+        });
+        streamApi["realtimeClient"].on("connected", () => {
+            console.log("✅ Successfully connected to websocket server");
+        });
+        streamApi["realtimeClient"].on("disconnected", () => {
+            console.log("❌ Disconnected from websocket server");
+        });
+        streamApi["realtimeClient"].on("error", (error) => {
+            console.error("❌ Connection error:", error);
+        });
+    });
+    (0, globals_1.it)('should receive wallet balance updates', (done) => {
+        const testWalletAddress = "WLHv2UAZm6z4KyaaELi5pjdbJh6RESMva1Rnn8pJVVh";
+        const testTokenAddress = "FZN7QZ8ZUUAxMPfxYEYkH3cXUASzH8EqA6B4tyCL8f1j";
+        const testPoolAddress = "C9U2Ksk6KKWvLEeo5yUQ7Xu46X7NzeBJtd9PBfuXaUSM";
+        const filter = 'balance < "20"';
+        console.log("📝 Creating subscription for wallet:", testWalletAddress);
+        streamApi.subscribeWalletBalance({
+            chain: 'sol',
+            walletAddress: testWalletAddress,
+            callback: (data) => {
+                console.log('📊 Received data:', JSON.stringify(data, null, 2));
+            },
+            filter
+        });
+        console.log("🚀 Initiating connection...");
+        streamApi.connect();
+    }, 300000);
+    (0, globals_1.it)('should receive wallet balance updates batch', (done) => {
+        const testWalletAddress1 = "WLHv2UAZm6z4KyaaELi5pjdbJh6RESMva1Rnn8pJVVh";
+        const testWalletAddress2 = "CreQJ2t94QK5dsxUZGXfPJ8Nx7wA9LHr5chxjSMkbNft";
+        const filter = 'balance < "20"';
+        console.log("📝 Creating batch subscription for wallets:", testWalletAddress1, "and", testWalletAddress2);
+        const unsubscribles = streamApi.batchSubscribe(() => [
+            streamApi.subscribeWalletBalance({
+                chain: 'sol',
+                walletAddress: testWalletAddress1,
+                callback: (data) => {
+                    console.log('📊 Received data for wallet 1:', JSON.stringify(data, null, 2));
+                },
+                filter
+            }),
+            streamApi.subscribeWalletBalance({
+                chain: 'sol',
+                walletAddress: testWalletAddress2,
+                callback: (data) => {
+                    console.log('📊 Received data for wallet 2:', JSON.stringify(data, null, 2));
+                },
+                filter
+            })
+        ]);
+        console.log("🚀 Initiating connection...");
+        streamApi.connect();
+    }, 300000);
+    (0, globals_1.it)('should receive ranking tokens list updates', (done) => {
+        console.log("📝 Creating subscription for ranking tokens list:");
+        streamApi.subscribeRankingTokensList({
+            chain: 'sol',
+            ranking_type: stream_model_1.RankingType.NEW,
+            callback: (data) => {
+                console.log('📊 Received data:', JSON.stringify(data, null, 2));
+            },
+        });
+        console.log("🚀 Initiating connection...");
+        streamApi.connect();
+    }, 300000);
+});
+//# sourceMappingURL=stream.test.js.map

package/dist/stream.test.js.map

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

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@chainstream-io/sdk",
+  "version": "0.0.1",
+  "description": "Dex API client and webhook verification library",
+  "author": "AI",
+  "repository": "https://github.com/chainstream-io/dex",
+  "type": "commonjs",
+  "keywords": [
+    "dex",
+    "typescript"
+  ],
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "typings": "./dist/index.d.ts",
+  "files": [
+    "src",
+    "dist/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "yarn run build",
+    "test": "jest",
+    "prepublishOnly": "yarn lint",
+    "lint:eslint": "eslint --ignore-path .lintignore --ext .js,.jsx,.ts,.tsx src",
+    "lint:prettier": "prettier --ignore-path .lintignore --write src/**.ts",
+    "lint": "yarn run lint:prettier && yarn run lint:eslint --max-warnings=0",
+    "lint:fix": "yarn run lint:prettier --write && yarn run lint:eslint --fix"
+  },
+  "dependencies": {
+    "@stablelib/base64": "^1.0.0",
+    "@chainstream-io/centrifuge": "1.0.0",
+    "whatwg-fetch": "^3.6.20",
+    "es6-promise": "^4.2.8",
+    "event-source-polyfill": "^1.0.31",
+    "fast-sha256": "^1.3.0",
+    "url-parse": "^1.5.10"
+  },
+  "devDependencies": {
+    "@stablelib/utf8": "^2.0.0",
+    "@types/event-source-polyfill": "^1.0.5",
+    "@types/jest": "^29.5.13",
+    "@types/url-parse": "1.4.11",
+    "@typescript-eslint/eslint-plugin": "^4.15.2",
+    "@typescript-eslint/parser": "^4.15.2",
+    "@typescript-eslint/typescript-estree": "^4.15.2",
+    "eslint": "^7.20.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.3.3",
+    "ts-jest": "^29.2.5",
+    "typescript": "^4.4.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/api/stream.fields.ts

@@ -0,0 +1,271 @@
+/**
+ * Field mappings for CEL filter expressions
+ * Maps human-readable field names to short field names used in the API
+ * Organized by subscription method to handle field name conflicts
+ */
+
+export interface FieldMapping {
+  readonly [key: string]: string;
+}
+
+export interface MethodFieldMappings {
+  readonly [methodName: string]: FieldMapping;
+}
+
+/**
+ * Field mappings organized by subscription method
+ * Each method can have its own field mappings to handle conflicts
+ */
+export const CEL_FIELD_MAPPINGS: MethodFieldMappings = {
+  // Wallet balance subscription fields
+  "subscribeWalletBalance": {
+    "walletAddress": "a",
+    "tokenAddress": "ta",
+    "tokenPriceInUsd": "tpiu",
+    "balance": "b",
+    "timestamp": "t",
+  },
+
+  // Token candles subscription fields
+  "subscribeTokenCandles": {
+    "open": "o",
+    "close": "c",
+    "high": "h",
+    "low": "l",
+    "volume": "v",
+    "resolution": "r",
+    "time": "t",
+    "number": "n",
+  },
+
+  // Token stats subscription fields
+  "subscribeTokenStats": {
+    "address": "a",
+    "timestamp": "t",
+    "buys1m": "b1m",
+    "sells1m": "s1m",
+    "buyers1m": "be1m",
+    "sellers1m": "se1m",
+    "buyVolumeInUsd1m": "bviu1m",
+    "sellVolumeInUsd1m": "sviu1m",
+    "price1m": "p1m",
+    "openInUsd1m": "oiu1m",
+    "closeInUsd1m": "ciu1m",
+    "buys5m": "b5m",
+    "sells5m": "s5m",
+    "buyers5m": "be5m",
+    "sellers5m": "se5m",
+    "buyVolumeInUsd5m": "bviu5m",
+    "sellVolumeInUsd5m": "sviu5m",
+    "price5m": "p5m",
+    "openInUsd5m": "oiu5m",
+    "closeInUsd5m": "ciu5m",
+    "buys15m": "b15m",
+    "sells15m": "s15m",
+    "buyers15m": "be15m",
+    "sellers15m": "se15m",
+    "buyVolumeInUsd15m": "bviu15m",
+    "sellVolumeInUsd15m": "sviu15m",
+    "price15m": "p15m",
+    "openInUsd15m": "oiu15m",
+    "closeInUsd15m": "ciu15m",
+    "buys30m": "b30m",
+    "sells30m": "s30m",
+    "buyers30m": "be30m",
+    "sellers30m": "se30m",
+    "buyVolumeInUsd30m": "bviu30m",
+    "sellVolumeInUsd30m": "sviu30m",
+    "price30m": "p30m",
+    "openInUsd30m": "oiu30m",
+    "closeInUsd30m": "ciu30m",
+    "buys1h": "b1h",
+    "sells1h": "s1h",
+    "buyers1h": "be1h",
+    "sellers1h": "se1h",
+    "buyVolumeInUsd1h": "bviu1h",
+    "sellVolumeInUsd1h": "sviu1h",
+    "price1h": "p1h",
+    "openInUsd1h": "oiu1h",
+    "closeInUsd1h": "ciu1h",
+    "buys4h": "b4h",
+    "sells4h": "s4h",
+    "buyers4h": "be4h",
+    "sellers4h": "se4h",
+    "buyVolumeInUsd4h": "bviu4h",
+    "sellVolumeInUsd4h": "sviu4h",
+    "price4h": "p4h",
+    "openInUsd4h": "oiu4h",
+    "closeInUsd4h": "ciu4h",
+    "buys24h": "b24h",
+    "sells24h": "s24h",
+    "buyers24h": "be24h",
+    "sellers24h": "se24h",
+    "buyVolumeInUsd24h": "bviu24h",
+    "sellVolumeInUsd24h": "sviu24h",
+    "price24h": "p24h",
+    "price": "p",
+    "openInUsd24h": "oiu24h",
+    "closeInUsd24h": "ciu24h",
+  },
+
+  // Token holder subscription fields
+  "subscribeTokenHolders": {
+    "tokenAddress": "a",
+    "holders": "h",
+    "top100Amount": "t100a",
+    "top10Amount": "t10a",
+    "top100Holders": "t100h",
+    "top10Holders": "t10h",
+    "top100Ratio": "t100r",
+    "top10Ratio": "t10r",
+    "timestamp": "ts",
+  },
+
+  // New token subscription fields
+  "subscribeNewToken": {
+    "tokenAddress": "a",
+    "name": "n",
+    "symbol": "s",
+    "createdAtMs": "cts",
+  },
+
+  // Token supply subscription fields
+  "subscribeTokenSupply": {
+    "tokenAddress": "a",
+    "supply": "s",
+    "timestamp": "ts",
+  },
+
+  // Dex pool balance subscription fields
+  "subscribeDexPoolBalance": {
+    "poolAddress": "a",
+    "tokenAAddress": "taa",
+    "tokenALiquidityInUsd": "taliu",
+    "tokenBAddress": "tba",
+    "tokenBLiquidityInUsd": "tbliu",
+  },
+
+  // Token liquidity subscription fields
+  "subscribeTokenLiquidity": {
+    "tokenAddress": "a",
+    "metricType": "t",
+    "value": "v",
+    "timestamp": "ts",
+  },
+
+  // New token metadata subscription fields
+  "subscribeNewTokensMetadata": {
+    "tokenAddress": "a",
+    "name": "n",
+    "symbol": "s",
+    "imageUrl": "iu",
+    "description": "de",
+    "socialMedia": "sm",
+    "createdAtMs": "cts",
+  },
+
+  // Token trades subscription fields
+  "subscribeTokenTrades": {
+    "tokenAddress": "a",
+    "timestamp": "t",
+    "kind": "k",
+    "buyAmount": "ba",
+    "buyAmountInUsd": "baiu",
+    "buyTokenAddress": "btma",
+    "buyTokenName": "btn",
+    "buyTokenSymbol": "bts",
+    "buyWalletAddress": "bwa",
+    "sellAmount": "sa",
+    "sellAmountInUsd": "saiu",
+    "sellTokenAddress": "stma",
+    "sellTokenName": "stn",
+    "sellTokenSymbol": "sts",
+    "sellWalletAddress": "swa",
+    "txHash": "h",
+  },
+
+  // Wallet token PnL subscription fields
+  "subscribeWalletPnl": {
+    "walletAddress": "a",
+    "tokenAddress": "ta",
+    "tokenPriceInUsd": "tpiu",
+    "timestamp": "t",
+    "opentime": "ot",
+    "lasttime": "lt",
+    "closetime": "ct",
+    "buyAmount": "ba",
+    "buyAmountInUsd": "baiu",
+    "buyCount": "bs",
+    "buyCount30d": "bs30d",
+    "buyCount7d": "bs7d",
+    "sellAmount": "sa",
+    "sellAmountInUsd": "saiu",
+    "sellCount": "ss",
+    "sellCount30d": "ss30d",
+    "sellCount7d": "ss7d",
+    "heldDurationTimestamp": "hdts",
+    "averageBuyPriceInUsd": "abpiu",
+    "averageSellPriceInUsd": "aspiu",
+    "unrealizedProfitInUsd": "upiu",
+    "unrealizedProfitRatio": "upr",
+    "realizedProfitInUsd": "rpiu",
+    "realizedProfitRatio": "rpr",
+    "totalRealizedProfitInUsd": "trpiu",
+    "totalRealizedProfitRatio": "trr",
+  },
+} as const;
+
+/**
+ * Get field mappings for a specific subscription method
+ * @param methodName - The name of the subscription method
+ * @returns Field mapping object for the method, or empty object if not found
+ */
+export function getFieldMappings(methodName: string): FieldMapping {
+  return CEL_FIELD_MAPPINGS[methodName] || {};
+}
+
+/**
+ * Replace long field names with short field names in a filter expression
+ * Automatically adds meta. prefix if not present
+ * @param filter - Original filter expression
+ * @param methodName - The name of the subscription method
+ * @returns Filter expression with short field names and meta. prefix
+ */
+export function replaceFilterFields(filter: string, methodName: string): string {
+  if (!filter) {return filter}
+  
+  const fieldMappings = getFieldMappings(methodName);
+  let result = filter;
+  
+  // Replace all long field names with short field names
+  for (const [longField, shortField] of Object.entries(fieldMappings)) {
+    // Handle both cases: with and without meta. prefix
+    const patterns = [
+      // Pattern 1: fieldName (without meta. prefix)
+      new RegExp(`\\b${longField}\\b`, "g"),
+      // Pattern 2: meta.fieldName (with meta. prefix)
+      new RegExp(`\\bmeta\\.${longField}\\b`, "g"),
+    ];
+    
+    patterns.forEach((pattern) => {
+      result = result.replace(pattern, `meta.${shortField}`);
+    });
+  }
+  
+  return result;
+}
+
+/**
+ * Type-safe field mapping for specific subscription methods
+ */
+export type SubscriptionMethod = keyof typeof CEL_FIELD_MAPPINGS;
+
+/**
+ * Get available field names for a specific subscription method
+ * @param methodName - The name of the subscription method
+ * @returns Array of available field names
+ */
+export function getAvailableFields(methodName: string): string[] {
+  const mappings = getFieldMappings(methodName);
+  return Object.keys(mappings);
+}