jay-network 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Winnode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,138 @@
+# jay-network
+
+JavaScript / TypeScript SDK for **[The Jay Network](https://thejaynetwork.com)** — a Cosmos SDK Layer‑1 with CosmWasm and IBC. Built on [CosmJS](https://github.com/cosmos/cosmjs).
+
+- **`JayClient`** — read-only queries (balances, validators, governance, IBC, supply)
+- **`JaySigningClient`** — transactions (send, stake, redelegate, claim, vote, IBC)
+- Chain constants + address helpers
+
+```bash
+npm install jay-network
+```
+
+## Network
+
+| Parameter | Value |
+|-----------|-------|
+| Chain ID | `thejaynetwork` |
+| Token | `JAY` (`ujay`, 6 decimals) |
+| Address prefix | `yjay` |
+| RPC | `https://pixture.thejaynetwork.com/rpc` |
+| REST | `https://pixture.thejaynetwork.com/rest` |
+
+## Querying (no wallet)
+
+```ts
+import { JayClient } from 'jay-network'
+
+const jay = new JayClient()
+
+const { height } = await jay.getLatestBlock()
+const balance = await jay.getJayBalance('yjay1...')
+const validators = await jay.getValidators()
+const proposals = await jay.getProposals()
+```
+
+Use custom endpoints:
+
+```ts
+const jay = new JayClient({
+  rpc: 'https://my-node:26657',
+  rest: 'https://my-node:1317',
+})
+```
+
+## Transactions (with a wallet)
+
+`JaySigningClient` works with any CosmJS `OfflineSigner` — Keplr, JAY Wallet, or a mnemonic.
+
+### Keplr / JAY Wallet (browser)
+
+```ts
+import { JaySigningClient, JAY_CHAIN_INFO, JAY_CHAIN_ID } from 'jay-network'
+
+await window.keplr.experimentalSuggestChain(JAY_CHAIN_INFO)
+await window.keplr.enable(JAY_CHAIN_ID)
+
+const signer = await window.keplr.getOfflineSignerAuto(JAY_CHAIN_ID)
+const [account] = await signer.getAccounts()
+
+const jay = await JaySigningClient.connect(signer, account.address)
+
+await jay.send('yjay1recipient...', '5')                 // send 5 JAY
+await jay.delegate('yjayvaloper1...', '100')             // stake 100 JAY
+await jay.claimRewards('yjayvaloper1...')                // claim rewards
+await jay.vote(12, 'VOTE_OPTION_YES')                    // vote on proposal #12
+```
+
+### Node.js (mnemonic)
+
+```ts
+import { DirectSecp256k1HdWallet } from '@cosmjs/proto-signing'
+import { JaySigningClient, JAY_PREFIX } from 'jay-network'
+
+const signer = await DirectSecp256k1HdWallet.fromMnemonic(process.env.MNEMONIC!, {
+  prefix: JAY_PREFIX,
+})
+const [account] = await signer.getAccounts()
+
+const jay = await JaySigningClient.connect(signer, account.address)
+await jay.send('yjay1...', '1')
+```
+
+## IBC transfer
+
+```ts
+await jay.ibcTransfer({
+  sourceChannel: 'channel-0',
+  receiver: 'cosmos1...',
+  amount: '2.5',
+})
+```
+
+## Helpers
+
+```ts
+import {
+  toMicro, fromMicro, reEncodeAddress, toValoper,
+  isValidatorOperator, isValidJayAddress, shortenAddress,
+} from 'jay-network'
+
+toMicro('1.5')                       // "1500000"
+fromMicro('1500000')                 // "1.500000"
+reEncodeAddress('yjay1...', 'cosmos')// "cosmos1..."
+toValoper('yjay1...')                // "yjayvaloper1..."
+isValidJayAddress('yjay1...')        // true
+```
+
+## API
+
+### `JayClient(options?)`
+`getLatestBlock` · `getNodeInfo` · `getBalances` · `getJayBalance` · `getValidators` · `getValidator` · `getDelegations` · `getRewards` · `getValidatorCommission` · `getProposals` · `getProposal` · `getSupply` · `getIbcChannels` · `resolveIbcDenom`
+
+### `JaySigningClient.connect(signer, address, options?)`
+`send` · `delegate` · `undelegate` · `redelegate` · `claimRewards` · `claimAllRewards` · `withdrawCommission` · `vote` · `ibcTransfer` · `disconnect`
+
+Every tx method accepts an optional `memo` and an optional explicit `StdFee` (pass a plain fee object, not a `GasPrice` instance).
+
+## Publishing (maintainers)
+
+This package lives in the [hub-jay](https://github.com/Winnode/hub-jay) repo (under `jaynetwork-sdk/`) and auto-publishes to npm via GitHub Actions.
+
+**One-time setup**
+1. Create an npm **Automation** access token at npmjs.com → Access Tokens.
+2. In the hub-jay repo: Settings → Secrets and variables → Actions → New repository secret.
+   - Name: `NPM_TOKEN`
+   - Value: the npm token
+   - Never commit the token to the repo.
+
+**Release flow**
+1. Bump the version in `jaynetwork-sdk/package.json`.
+2. Create a GitHub Release in the hub-jay repo.
+3. The `Publish SDK to npm` workflow builds `jaynetwork-sdk/` and runs `npm publish --access public`.
+
+You can also trigger it manually from the Actions tab (workflow_dispatch).
+
+## License
+
+MIT © [Winnode](https://github.com/Winnode)

package/dist/index.cjs

@@ -0,0 +1,426 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_REST: () => DEFAULT_REST,
+  DEFAULT_RPC: () => DEFAULT_RPC,
+  JAY_CHAIN_ID: () => JAY_CHAIN_ID,
+  JAY_CHAIN_INFO: () => JAY_CHAIN_INFO,
+  JAY_CHAIN_NAME: () => JAY_CHAIN_NAME,
+  JAY_DECIMALS: () => JAY_DECIMALS,
+  JAY_DENOM: () => JAY_DENOM,
+  JAY_PREFIX: () => JAY_PREFIX,
+  JAY_SYMBOL: () => JAY_SYMBOL,
+  JayClient: () => JayClient,
+  JaySigningClient: () => JaySigningClient,
+  fromMicro: () => fromMicro,
+  isValidJayAddress: () => isValidJayAddress,
+  isValidatorOperator: () => isValidatorOperator,
+  jayCoin: () => jayCoin,
+  reEncodeAddress: () => reEncodeAddress,
+  shortenAddress: () => shortenAddress,
+  toMicro: () => toMicro,
+  toValoper: () => toValoper
+});
+module.exports = __toCommonJS(index_exports);
+
+// 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
+var import_encoding = require("@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 } = (0, import_encoding.fromBech32)(address);
+  return (0, import_encoding.toBech32)(prefix, data);
+}
+function toValoper(accountAddress) {
+  const { prefix, data } = (0, import_encoding.fromBech32)(accountAddress);
+  return (0, import_encoding.toBech32)(`${prefix}valoper`, data);
+}
+function isValidatorOperator(accountAddress, valoperAddress) {
+  try {
+    return toValoper(accountAddress) === valoperAddress;
+  } catch {
+    return false;
+  }
+}
+function isValidJayAddress(address) {
+  try {
+    return (0, import_encoding.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
+var import_stargate = require("@cosmjs/stargate");
+var import_long = __toESM(require("long"), 1);
+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 import_stargate.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: import_long.default.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();
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  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
+});