jay-network 0.1.0

package/dist/index.js

@@ -0,0 +1,371 @@
+// src/chain.ts
+var JAY_CHAIN_ID = "thejaynetwork";
+var JAY_CHAIN_NAME = "Jay Network";
+var JAY_DENOM = "ujay";
+var JAY_SYMBOL = "JAY";
+var JAY_DECIMALS = 6;
+var JAY_PREFIX = "yjay";
+var DEFAULT_RPC = "https://pixture.thejaynetwork.com/rpc";
+var DEFAULT_REST = "https://pixture.thejaynetwork.com/rest";
+var JAY_CHAIN_INFO = {
+  chainId: JAY_CHAIN_ID,
+  chainName: JAY_CHAIN_NAME,
+  rpc: DEFAULT_RPC,
+  rest: DEFAULT_REST,
+  bip44: { coinType: 118 },
+  bech32Config: {
+    bech32PrefixAccAddr: JAY_PREFIX,
+    bech32PrefixAccPub: `${JAY_PREFIX}pub`,
+    bech32PrefixValAddr: `${JAY_PREFIX}valoper`,
+    bech32PrefixValPub: `${JAY_PREFIX}valoperpub`,
+    bech32PrefixConsAddr: `${JAY_PREFIX}valcons`,
+    bech32PrefixConsPub: `${JAY_PREFIX}valconspub`
+  },
+  currencies: [
+    { coinDenom: JAY_SYMBOL, coinMinimalDenom: JAY_DENOM, coinDecimals: JAY_DECIMALS }
+  ],
+  feeCurrencies: [
+    {
+      coinDenom: JAY_SYMBOL,
+      coinMinimalDenom: JAY_DENOM,
+      coinDecimals: JAY_DECIMALS,
+      gasPriceStep: { low: 0.01, average: 0.025, high: 0.04 }
+    }
+  ],
+  stakeCurrency: {
+    coinDenom: JAY_SYMBOL,
+    coinMinimalDenom: JAY_DENOM,
+    coinDecimals: JAY_DECIMALS
+  }
+};
+
+// src/utils.ts
+import { fromBech32, toBech32 } from "@cosmjs/encoding";
+function toMicro(amount, decimals = JAY_DECIMALS) {
+  const n = typeof amount === "string" ? parseFloat(amount) : amount;
+  if (!isFinite(n)) throw new Error(`Invalid amount: ${amount}`);
+  return Math.floor(n * Math.pow(10, decimals)).toString();
+}
+function fromMicro(amount, decimals = JAY_DECIMALS) {
+  const n = typeof amount === "string" ? parseInt(amount, 10) : amount;
+  return (n / Math.pow(10, decimals)).toFixed(decimals);
+}
+function jayCoin(amount, denom = JAY_DENOM) {
+  return { denom, amount: toMicro(amount) };
+}
+function reEncodeAddress(address, prefix) {
+  const { data } = fromBech32(address);
+  return toBech32(prefix, data);
+}
+function toValoper(accountAddress) {
+  const { prefix, data } = fromBech32(accountAddress);
+  return toBech32(`${prefix}valoper`, data);
+}
+function isValidatorOperator(accountAddress, valoperAddress) {
+  try {
+    return toValoper(accountAddress) === valoperAddress;
+  } catch {
+    return false;
+  }
+}
+function isValidJayAddress(address) {
+  try {
+    return fromBech32(address).prefix === JAY_PREFIX;
+  } catch {
+    return false;
+  }
+}
+function shortenAddress(address, head = 10, tail = 6) {
+  if (!address || address.length <= head + tail) return address;
+  return `${address.slice(0, head)}\u2026${address.slice(-tail)}`;
+}
+
+// src/client.ts
+var JayClient = class {
+  constructor(options = {}) {
+    this.rpc = options.rpc ?? DEFAULT_RPC;
+    this.rest = options.rest ?? DEFAULT_REST;
+  }
+  async getJson(base, path) {
+    const res = await fetch(`${base}${path}`);
+    if (!res.ok) throw new Error(`Request failed (${res.status}): ${path}`);
+    return res.json();
+  }
+  /** Latest block height and time from the RPC status endpoint. */
+  async getLatestBlock() {
+    const data = await this.getJson(this.rpc, "/status");
+    const info = data.result.sync_info;
+    return { height: info.latest_block_height, time: info.latest_block_time };
+  }
+  /** Node sync / network identity info. */
+  async getNodeInfo() {
+    return this.getJson(this.rest, "/cosmos/base/tendermint/v1beta1/node_info");
+  }
+  /** All balances for an address. Amounts are in base units (ujay). */
+  async getBalances(address) {
+    const data = await this.getJson(
+      this.rest,
+      `/cosmos/bank/v1beta1/balances/${address}?pagination.limit=200`
+    );
+    return data.balances ?? [];
+  }
+  /** Native JAY balance as a human-readable string. */
+  async getJayBalance(address) {
+    const balances = await this.getBalances(address);
+    const jay = balances.find((c) => c.denom === JAY_DENOM);
+    return fromMicro(jay?.amount ?? "0");
+  }
+  /** Bonded validators (optionally filter by status). */
+  async getValidators(status = "BOND_STATUS_BONDED") {
+    const data = await this.getJson(
+      this.rest,
+      `/cosmos/staking/v1beta1/validators?status=${status}&pagination.limit=500`
+    );
+    return data.validators ?? [];
+  }
+  /** A single validator by operator (valoper) address. */
+  async getValidator(valoperAddress) {
+    const data = await this.getJson(
+      this.rest,
+      `/cosmos/staking/v1beta1/validators/${valoperAddress}`
+    );
+    return data.validator;
+  }
+  /** All delegations for a delegator. */
+  async getDelegations(delegatorAddress) {
+    const data = await this.getJson(
+      this.rest,
+      `/cosmos/staking/v1beta1/delegations/${delegatorAddress}`
+    );
+    return data.delegation_responses ?? [];
+  }
+  /** Pending staking rewards for a delegator across all validators. */
+  async getRewards(delegatorAddress) {
+    const data = await this.getJson(
+      this.rest,
+      `/cosmos/distribution/v1beta1/delegators/${delegatorAddress}/rewards`
+    );
+    return data;
+  }
+  /** Validator commission accrued by an operator. */
+  async getValidatorCommission(valoperAddress) {
+    const data = await this.getJson(
+      this.rest,
+      `/cosmos/distribution/v1beta1/validators/${valoperAddress}/commission`
+    );
+    const jay = data.commission?.commission?.find(
+      (c) => c.denom === JAY_DENOM
+    );
+    return fromMicro(jay?.amount ?? "0");
+  }
+  /** Governance proposals (optionally filter by status). */
+  async getProposals(status) {
+    const q = status ? `?proposal_status=${status}` : "";
+    const data = await this.getJson(this.rest, `/cosmos/gov/v1/proposals${q}`);
+    return data.proposals ?? [];
+  }
+  /** A single governance proposal by id. */
+  async getProposal(proposalId) {
+    const data = await this.getJson(this.rest, `/cosmos/gov/v1/proposals/${proposalId}`);
+    return data.proposal;
+  }
+  /** Total token supply. */
+  async getSupply() {
+    const data = await this.getJson(this.rest, "/cosmos/bank/v1beta1/supply?pagination.limit=50");
+    return data.supply ?? [];
+  }
+  /** Open IBC transfer channels. */
+  async getIbcChannels() {
+    const data = await this.getJson(
+      this.rest,
+      "/ibc/core/channel/v1/channels?pagination.limit=300"
+    );
+    return (data.channels ?? []).filter(
+      (c) => c.state === "STATE_OPEN" && c.port_id === "transfer"
+    );
+  }
+  /** Resolve an `ibc/<hash>` denom to its base denom + path. */
+  async resolveIbcDenom(denom) {
+    if (!denom.startsWith("ibc/")) return { baseDenom: denom, path: "" };
+    const hash = denom.slice(4);
+    const data = await this.getJson(
+      this.rest,
+      `/ibc/apps/transfer/v1/denom_traces/${hash}`
+    );
+    const trace = data.denom_trace;
+    return { baseDenom: trace?.base_denom ?? denom, path: trace?.path ?? "" };
+  }
+};
+
+// src/signer.ts
+import { SigningStargateClient } from "@cosmjs/stargate";
+import Long from "long";
+var VOTE_ENUM = {
+  VOTE_OPTION_YES: 1,
+  VOTE_OPTION_ABSTAIN: 2,
+  VOTE_OPTION_NO: 3,
+  VOTE_OPTION_NO_WITH_VETO: 4
+};
+function defaultFee(gas = "250000", amount = "7500") {
+  return { amount: [{ denom: JAY_DENOM, amount }], gas };
+}
+var JaySigningClient = class _JaySigningClient {
+  constructor(client, address) {
+    this.client = client;
+    this.address = address;
+  }
+  /** Connect using an offline signer and the sender address. */
+  static async connect(signer, address, options = {}) {
+    const rpc = options.rpc ?? DEFAULT_RPC;
+    const client = await SigningStargateClient.connectWithSigner(rpc, signer);
+    return new _JaySigningClient(client, address);
+  }
+  /** Underlying CosmJS client for advanced use. */
+  get raw() {
+    return this.client;
+  }
+  async broadcast(messages, memo = "", fee) {
+    const result = await this.client.signAndBroadcast(
+      this.address,
+      messages,
+      fee ?? defaultFee(),
+      memo
+    );
+    if (result.code !== void 0 && result.code !== 0) {
+      throw new Error(`Transaction failed: ${result.rawLog}`);
+    }
+    return { txHash: result.transactionHash, height: result.height, raw: result };
+  }
+  /** Send JAY to another address. */
+  async send(to, amount, memo = "", fee) {
+    const msg = {
+      typeUrl: "/cosmos.bank.v1beta1.MsgSend",
+      value: {
+        fromAddress: this.address,
+        toAddress: to,
+        amount: [{ denom: JAY_DENOM, amount: toMicro(amount) }]
+      }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** Delegate (stake) JAY to a validator. */
+  async delegate(valoperAddress, amount, memo = "", fee) {
+    const msg = {
+      typeUrl: "/cosmos.staking.v1beta1.MsgDelegate",
+      value: {
+        delegatorAddress: this.address,
+        validatorAddress: valoperAddress,
+        amount: { denom: JAY_DENOM, amount: toMicro(amount) }
+      }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** Undelegate (unstake) JAY from a validator. */
+  async undelegate(valoperAddress, amount, memo = "", fee) {
+    const msg = {
+      typeUrl: "/cosmos.staking.v1beta1.MsgUndelegate",
+      value: {
+        delegatorAddress: this.address,
+        validatorAddress: valoperAddress,
+        amount: { denom: JAY_DENOM, amount: toMicro(amount) }
+      }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** Move stake from one validator to another. */
+  async redelegate(srcValoper, dstValoper, amount, memo = "", fee) {
+    const msg = {
+      typeUrl: "/cosmos.staking.v1beta1.MsgBeginRedelegate",
+      value: {
+        delegatorAddress: this.address,
+        validatorSrcAddress: srcValoper,
+        validatorDstAddress: dstValoper,
+        amount: { denom: JAY_DENOM, amount: toMicro(amount) }
+      }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** Claim staking rewards from one validator. */
+  async claimRewards(valoperAddress, memo = "", fee) {
+    const msg = {
+      typeUrl: "/cosmos.distribution.v1beta1.MsgWithdrawDelegatorReward",
+      value: { delegatorAddress: this.address, validatorAddress: valoperAddress }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** Claim staking rewards from many validators in one tx. */
+  async claimAllRewards(valoperAddresses, memo = "", fee) {
+    const msgs = valoperAddresses.map((validatorAddress) => ({
+      typeUrl: "/cosmos.distribution.v1beta1.MsgWithdrawDelegatorReward",
+      value: { delegatorAddress: this.address, validatorAddress }
+    }));
+    return this.broadcast(msgs, memo, fee ?? defaultFee("400000"));
+  }
+  /** Withdraw a validator operator's accrued commission. */
+  async withdrawCommission(valoperAddress, memo = "", fee) {
+    const msg = {
+      typeUrl: "/cosmos.distribution.v1beta1.MsgWithdrawValidatorCommission",
+      value: { validatorAddress: valoperAddress }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** Vote on a governance proposal (gov v1). */
+  async vote(proposalId, option, memo = "", fee) {
+    const value = VOTE_ENUM[option];
+    if (!value) throw new Error(`Invalid vote option: ${option}`);
+    const msg = {
+      typeUrl: "/cosmos.gov.v1.MsgVote",
+      value: {
+        proposalId: Long.fromNumber(Number(proposalId)),
+        voter: this.address,
+        option: value,
+        metadata: ""
+      }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** IBC transfer of JAY to another chain. */
+  async ibcTransfer(params, memo = "", fee) {
+    const { sourceChannel, receiver, amount, denom = JAY_DENOM, timeoutMinutes = 10 } = params;
+    const timeoutTimestamp = (Date.now() + timeoutMinutes * 60 * 1e3) * 1e6;
+    const msg = {
+      typeUrl: "/ibc.applications.transfer.v1.MsgTransfer",
+      value: {
+        sourcePort: "transfer",
+        sourceChannel,
+        token: { denom, amount: toMicro(amount) },
+        sender: this.address,
+        receiver,
+        timeoutHeight: { revisionNumber: "0", revisionHeight: "0" },
+        timeoutTimestamp: timeoutTimestamp.toString(),
+        memo
+      }
+    };
+    return this.broadcast([msg], memo, fee);
+  }
+  /** Disconnect the underlying client. */
+  disconnect() {
+    this.client.disconnect();
+  }
+};
+export {
+  DEFAULT_REST,
+  DEFAULT_RPC,
+  JAY_CHAIN_ID,
+  JAY_CHAIN_INFO,
+  JAY_CHAIN_NAME,
+  JAY_DECIMALS,
+  JAY_DENOM,
+  JAY_PREFIX,
+  JAY_SYMBOL,
+  JayClient,
+  JaySigningClient,
+  fromMicro,
+  isValidJayAddress,
+  isValidatorOperator,
+  jayCoin,
+  reEncodeAddress,
+  shortenAddress,
+  toMicro,
+  toValoper
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "jay-network",
+  "version": "0.1.0",
+  "description": "JavaScript/TypeScript SDK for The Jay Network — queries, staking, governance, and transfers built on CosmJS.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "dev": "tsup src/index.ts --format esm,cjs --dts --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "jay-network",
+    "thejaynetwork",
+    "cosmos",
+    "cosmjs",
+    "cosmwasm",
+    "blockchain",
+    "sdk",
+    "staking",
+    "ibc"
+  ],
+  "author": "Winnode <maladarsih@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Winnode/hub-jay.git",
+    "directory": "jaynetwork-sdk"
+  },
+  "homepage": "https://thejaynetwork.com",
+  "dependencies": {
+    "@cosmjs/encoding": "^0.32.0",
+    "@cosmjs/proto-signing": "^0.32.0",
+    "@cosmjs/stargate": "^0.32.0",
+    "long": "^5.2.3"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}