blue-js-sdk 2.0.0

package/proto/sentinel/subscription/v3/events.proto

@@ -0,0 +1,65 @@
+syntax = "proto3";
+package sentinel.subscription.v3;
+
+import "gogoproto/gogo.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/x/subscription/types/v3";
+option (gogoproto.equal_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+message EventAllocate {
+  uint64 subscription_id = 1 [(gogoproto.customname) = "SubscriptionID"];
+  string acc_address = 2;
+  string granted_bytes = 3;
+  string utilised_bytes = 4;
+}
+
+message EventCreate {
+  uint64 subscription_id = 1 [(gogoproto.customname) = "SubscriptionID"];
+  uint64 plan_id = 2 [(gogoproto.customname) = "PlanID"];
+  string acc_address = 3;
+  string price = 4;
+}
+
+message EventCreateSession {
+  uint64 session_id = 1 [(gogoproto.customname) = "SessionID"];
+  uint64 subscription_id = 4 [(gogoproto.customname) = "SubscriptionID"];
+  string acc_address = 2;
+  string node_address = 3;
+}
+
+message EventEnd {
+  uint64 subscription_id = 1 [(gogoproto.customname) = "SubscriptionID"];
+  uint64 plan_id = 2 [(gogoproto.customname) = "PlanID"];
+  string acc_address = 3;
+}
+
+message EventPay {
+  uint64 subscription_id = 1 [(gogoproto.customname) = "SubscriptionID"];
+  uint64 plan_id = 2 [(gogoproto.customname) = "PlanID"];
+  string acc_address = 3;
+  string prov_address = 4;
+  string payment = 5;
+  string staking_reward = 6;
+}
+
+message EventRenew {
+  uint64 subscription_id = 1 [(gogoproto.customname) = "SubscriptionID"];
+  uint64 plan_id = 2 [(gogoproto.customname) = "PlanID"];
+  string acc_address = 3;
+  string price = 4;
+}
+
+message EventUpdateDetails {
+  uint64 subscription_id = 1 [(gogoproto.customname) = "SubscriptionID"];
+  uint64 plan_id = 2 [(gogoproto.customname) = "PlanID"];
+  string acc_address = 3;
+  string renewal_price_policy = 4;
+}
+
+message EventUpdateStatus {
+  uint64 subscription_id = 1 [(gogoproto.customname) = "SubscriptionID"];
+  uint64 plan_id = 2 [(gogoproto.customname) = "PlanID"];
+  string acc_address = 3;
+  string status = 4;
+}

package/proto/sentinel/subscription/v3/genesis.proto

@@ -0,0 +1,17 @@
+syntax = "proto3";
+package sentinel.subscription.v3;
+
+import "gogoproto/gogo.proto";
+import "sentinel/subscription/v2/allocation.proto";
+import "sentinel/subscription/v3/params.proto";
+import "sentinel/subscription/v3/subscription.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/x/subscription/types/v3";
+option (gogoproto.equal_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+message GenesisState {
+  repeated sentinel.subscription.v2.Allocation allocations = 1 [(gogoproto.nullable) = false];
+  repeated Subscription subscriptions = 2 [(gogoproto.nullable) = false];
+  Params params = 3 [(gogoproto.nullable) = false];
+}

package/proto/sentinel/subscription/v3/msg.proto

@@ -0,0 +1,83 @@
+syntax = "proto3";
+package sentinel.subscription.v3;
+
+import "gogoproto/gogo.proto";
+import "sentinel/subscription/v3/params.proto";
+import "sentinel/types/v1/renewal.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/x/subscription/types/v3";
+option (gogoproto.equal_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+message MsgCancelSubscriptionRequest {
+  string from = 1;
+  uint64 id = 2 [(gogoproto.customname) = "ID"];
+}
+
+message MsgRenewSubscriptionRequest {
+  string from = 1;
+  uint64 id = 2 [(gogoproto.customname) = "ID"];
+  string denom = 3;
+}
+
+message MsgShareSubscriptionRequest {
+  string from = 1;
+  uint64 id = 2 [(gogoproto.customname) = "ID"];
+  string acc_address = 3;
+  string bytes = 4 [
+    (gogoproto.customtype) = "cosmossdk.io/math.Int",
+    (gogoproto.nullable) = false
+  ];
+}
+
+message MsgStartSubscriptionRequest {
+  string from = 1;
+  uint64 id = 2 [(gogoproto.customname) = "ID"];
+  string denom = 3;
+  sentinel.types.v1.RenewalPricePolicy renewal_price_policy = 4;
+}
+
+message MsgUpdateSubscriptionRequest {
+  string from = 1;
+  uint64 id = 2 [(gogoproto.customname) = "ID"];
+  sentinel.types.v1.RenewalPricePolicy renewal_price_policy = 3;
+}
+
+message MsgStartSessionRequest {
+  string from = 1;
+  uint64 id = 2 [(gogoproto.customname) = "ID"];
+  string node_address = 3;
+}
+
+message MsgUpdateParamsRequest {
+  string from = 1;
+  Params params = 2 [(gogoproto.nullable) = false];
+}
+
+message MsgCancelSubscriptionResponse {}
+
+message MsgRenewSubscriptionResponse {}
+
+message MsgShareSubscriptionResponse {}
+
+message MsgStartSubscriptionResponse {
+  uint64 id = 1 [(gogoproto.customname) = "ID"];
+}
+
+message MsgUpdateSubscriptionResponse {}
+
+message MsgStartSessionResponse {
+  uint64 id = 1 [(gogoproto.customname) = "ID"];
+}
+
+message MsgUpdateParamsResponse {}
+
+service MsgService {
+  rpc MsgCancelSubscription(MsgCancelSubscriptionRequest) returns (MsgCancelSubscriptionResponse);
+  rpc MsgRenewSubscription(MsgRenewSubscriptionRequest) returns (MsgRenewSubscriptionResponse);
+  rpc MsgShareSubscription(MsgShareSubscriptionRequest) returns (MsgShareSubscriptionResponse);
+  rpc MsgStartSubscription(MsgStartSubscriptionRequest) returns (MsgStartSubscriptionResponse);
+  rpc MsgUpdateSubscription(MsgUpdateSubscriptionRequest) returns (MsgUpdateSubscriptionResponse);
+  rpc MsgStartSession(MsgStartSessionRequest) returns (MsgStartSessionResponse);
+  rpc MsgUpdateParams(MsgUpdateParamsRequest) returns (MsgUpdateParamsResponse);
+}

package/proto/sentinel/subscription/v3/params.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+package sentinel.subscription.v3;
+
+import "gogoproto/gogo.proto";
+import "google/protobuf/duration.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/x/subscription/types/v3";
+option (gogoproto.equal_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+message Params {
+  int64 max_allocations = 1;
+  string staking_share = 2 [
+    (gogoproto.customtype) = "cosmossdk.io/math.LegacyDec",
+    (gogoproto.nullable) = false
+  ];
+  google.protobuf.Duration status_timeout = 3 [
+    (gogoproto.nullable) = false,
+    (gogoproto.stdduration) = true
+  ];
+}

package/proto/sentinel/subscription/v3/subscription.proto

@@ -0,0 +1,33 @@
+syntax = "proto3";
+package sentinel.subscription.v3;
+
+import "gogoproto/gogo.proto";
+import "google/protobuf/timestamp.proto";
+import "sentinel/types/v1/price.proto";
+import "sentinel/types/v1/renewal.proto";
+import "sentinel/types/v1/status.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/x/subscription/types/v3";
+option (gogoproto.equal_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+message Subscription {
+  uint64 id = 1 [(gogoproto.customname) = "ID"];
+  string acc_address = 2;
+  uint64 plan_id = 3 [(gogoproto.customname) = "PlanID"];
+  sentinel.types.v1.Price price = 4 [(gogoproto.nullable) = false];
+  sentinel.types.v1.RenewalPricePolicy renewal_price_policy = 5;
+  sentinel.types.v1.Status status = 6;
+  google.protobuf.Timestamp inactive_at = 7 [
+    (gogoproto.nullable) = false,
+    (gogoproto.stdtime) = true
+  ];
+  google.protobuf.Timestamp start_at = 8 [
+    (gogoproto.nullable) = false,
+    (gogoproto.stdtime) = true
+  ];
+  google.protobuf.Timestamp status_at = 9 [
+    (gogoproto.nullable) = false,
+    (gogoproto.stdtime) = true
+  ];
+}

package/proto/sentinel/types/v1/bandwidth.proto

@@ -0,0 +1,19 @@
+syntax = "proto3";
+package sentinel.types.v1;
+
+import "gogoproto/gogo.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/types/v1";
+option (gogoproto.equal_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+message Bandwidth {
+  string upload = 1 [
+    (gogoproto.customtype) = "cosmossdk.io/math.Int",
+    (gogoproto.nullable) = false
+  ];
+  string download = 2 [
+    (gogoproto.customtype) = "cosmossdk.io/math.Int",
+    (gogoproto.nullable) = false
+  ];
+}

package/proto/sentinel/types/v1/price.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+package sentinel.types.v1;
+
+import "gogoproto/gogo.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/types/v1";
+option (gogoproto.equal_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+option (gogoproto.goproto_stringer_all) = false;
+
+message Price {
+  string denom = 1;
+  string base_value = 2 [
+    (gogoproto.customtype) = "cosmossdk.io/math.LegacyDec",
+    (gogoproto.nullable) = false
+  ];
+  string quote_value = 3 [
+    (gogoproto.customtype) = "cosmossdk.io/math.Int",
+    (gogoproto.nullable) = false
+  ];
+}

package/proto/sentinel/types/v1/renewal.proto

@@ -0,0 +1,21 @@
+syntax = "proto3";
+package sentinel.types.v1;
+
+import "gogoproto/gogo.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/types/v1";
+option (gogoproto.goproto_enum_prefix_all) = false;
+option (gogoproto.goproto_enum_stringer_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+// Enum for renewal price policies
+enum RenewalPricePolicy {
+  RENEWAL_PRICE_POLICY_UNSPECIFIED = 0 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyUnspecified"]; // Default value, do not renew
+  RENEWAL_PRICE_POLICY_IF_LESSER = 1 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyIfLesser"]; // Renew if the current price is lesser than the previous price
+  RENEWAL_PRICE_POLICY_IF_LESSER_OR_EQUAL = 2 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyIfLesserOrEqual"]; // Renew if the current price is lesser than or equal to the previous price
+  RENEWAL_PRICE_POLICY_IF_EQUAL = 3 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyIfEqual"]; // Renew if the current price is equal to the previous price
+  RENEWAL_PRICE_POLICY_IF_NOT_EQUAL = 4 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyIfNotEqual"]; // Renew if the current price is not equal to the previous price
+  RENEWAL_PRICE_POLICY_IF_GREATER = 5 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyIfGreater"]; // Renew if the current price is greater than the previous price
+  RENEWAL_PRICE_POLICY_IF_GREATER_OR_EQUAL = 6 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyIfGreaterOrEqual"]; // Renew if the current price is greater than or equal to the previous price
+  RENEWAL_PRICE_POLICY_ALWAYS = 7 [(gogoproto.enumvalue_customname) = "RenewalPricePolicyAlways"]; // Always renew
+}

package/proto/sentinel/types/v1/status.proto

@@ -0,0 +1,16 @@
+syntax = "proto3";
+package sentinel.types.v1;
+
+import "gogoproto/gogo.proto";
+
+option go_package = "github.com/sentinel-official/sentinelhub/v13/types/v1";
+option (gogoproto.goproto_enum_prefix_all) = false;
+option (gogoproto.goproto_enum_stringer_all) = false;
+option (gogoproto.goproto_getters_all) = false;
+
+enum Status {
+  STATUS_UNSPECIFIED = 0 [(gogoproto.enumvalue_customname) = "StatusUnspecified"];
+  STATUS_ACTIVE = 1 [(gogoproto.enumvalue_customname) = "StatusActive"];
+  STATUS_INACTIVE_PENDING = 2 [(gogoproto.enumvalue_customname) = "StatusInactivePending"];
+  STATUS_INACTIVE = 3 [(gogoproto.enumvalue_customname) = "StatusInactive"];
+}

package/protocol/encoding.js

@@ -0,0 +1,341 @@
+/**
+ * Sentinel v3 Protobuf Encoding & Message Encoders
+ *
+ * Manual protobuf encoding — avoids needing proto-generated code for v3 types.
+ * Field tag = (field_number << 3) | wire_type  (0=varint, 2=length-delimited)
+ *
+ * Contains:
+ *   - Encoding primitives (encodeVarint, protoString, protoInt64, protoEmbedded)
+ *   - Value converters (decToScaledInt, encodePrice, encodeDuration)
+ *   - ALL message encoders (MsgStartSession, MsgEndSession, subscriptions, node ops, plan details)
+ */
+
+// ─── Encoding Primitives ────────────────────────────────────────────────────
+
+export function encodeVarint(value) {
+  let n = BigInt(value);
+  if (n < 0n) throw new RangeError(`encodeVarint: negative values not supported (got ${n})`);
+  const bytes = [];
+  do {
+    let b = Number(n & 0x7fn);
+    n >>= 7n;
+    if (n > 0n) b |= 0x80;
+    bytes.push(b);
+  } while (n > 0n);
+  return Buffer.from(bytes);
+}
+
+export function protoString(fieldNum, str) {
+  if (!str) return Buffer.alloc(0);
+  const b = Buffer.from(str, 'utf8');
+  return Buffer.concat([encodeVarint((BigInt(fieldNum) << 3n) | 2n), encodeVarint(b.length), b]);
+}
+
+export function protoInt64(fieldNum, n) {
+  if (n === null || n === undefined) return Buffer.alloc(0);
+  return Buffer.concat([encodeVarint((BigInt(fieldNum) << 3n) | 0n), encodeVarint(n)]);
+}
+
+export function protoEmbedded(fieldNum, msgBytes) {
+  if (!msgBytes || msgBytes.length === 0) return Buffer.alloc(0);
+  return Buffer.concat([encodeVarint((BigInt(fieldNum) << 3n) | 2n), encodeVarint(msgBytes.length), msgBytes]);
+}
+
+// ─── Value Converters ───────────────────────────────────────────────────────
+
+/**
+ * Convert sdk.Dec string to scaled big.Int string (multiply by 10^18).
+ * "0.003000000000000000" → "3000000000000000"
+ * "40152030"             → "40152030000000000000000000"  (only for sdk.Dec fields)
+ */
+export function decToScaledInt(decStr) {
+  if (decStr == null || decStr === '') return '0';
+  const s = String(decStr).trim();
+  if (!s || s === 'undefined' || s === 'null') return '0';
+  const dotIdx = s.indexOf('.');
+  if (dotIdx === -1) {
+    // Integer — multiply by 10^18
+    return s + '0'.repeat(18);
+  }
+  const intPart = s.slice(0, dotIdx);
+  const fracPart = s.slice(dotIdx + 1);
+  // Pad or trim fractional part to exactly 18 digits
+  const frac18 = (fracPart + '0'.repeat(18)).slice(0, 18);
+  const combined = (intPart === '' || intPart === '0' ? '' : intPart) + frac18;
+  // Remove leading zeros (but keep at least one digit)
+  const trimmed = combined.replace(/^0+/, '') || '0';
+  return trimmed;
+}
+
+/**
+ * Encode sentinel.types.v1.Price { denom, base_value, quote_value }
+ * base_value is sdk.Dec → encode as scaled big.Int string
+ * quote_value is sdk.Int → encode as integer string
+ */
+export function encodePrice({ denom, base_value, quote_value }) {
+  const baseValEncoded = decToScaledInt(String(base_value));
+  return Buffer.concat([
+    protoString(1, denom),
+    protoString(2, baseValEncoded),
+    protoString(3, String(quote_value)),
+  ]);
+}
+
+/**
+ * Encode google.protobuf.Duration { seconds, nanos }
+ * Used by MsgCreatePlanRequest and MsgUpdatePlanDetails for plan duration.
+ */
+export function encodeDuration({ seconds, nanos = 0 }) {
+  return Buffer.concat([
+    protoInt64(1, seconds),
+    nanos ? protoInt64(2, nanos) : Buffer.alloc(0),
+  ]);
+}
+
+// ─── Session Message Encoders ───────────────────────────────────────────────
+
+/**
+ * Encode sentinel.node.v3.MsgStartSessionRequest
+ * Replaces old nodeSubscribe + sessionStart (now one tx).
+ *
+ * Fields:
+ *   1: from         (string) — account address
+ *   2: node_address (string) — node's sentnode1... address
+ *   3: gigabytes    (int64)
+ *   4: hours        (int64, 0 if using gigabytes)
+ *   5: max_price    (Price, optional) — max price user will pay per GB
+ */
+export function encodeMsgStartSession({ from, node_address, gigabytes = 1, hours = 0, max_price }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoString(2, node_address),
+    protoInt64(3, gigabytes),
+    hours ? protoInt64(4, hours) : Buffer.alloc(0),
+    max_price ? protoEmbedded(5, encodePrice(max_price)) : Buffer.alloc(0),
+  ]));
+}
+
+/**
+ * MsgStartSubscriptionRequest (sentinel.subscription.v3):
+ *   1: from   (string)
+ *   2: id     (uint64, plan ID)
+ *   3: denom  (string, e.g. "udvpn")
+ *   4: renewal_price_policy (enum/int64, optional)
+ */
+export function encodeMsgStartSubscription({ from, id, denom = 'udvpn', renewalPricePolicy = 0 }) {
+  const parts = [
+    protoString(1, from),
+    protoInt64(2, id),
+    protoString(3, denom),
+  ];
+  if (renewalPricePolicy) parts.push(protoInt64(4, renewalPricePolicy));
+  return Uint8Array.from(Buffer.concat(parts));
+}
+
+/**
+ * MsgStartSessionRequest (sentinel.subscription.v3) — start session via subscription:
+ *   1: from            (string)
+ *   2: id              (uint64, subscription ID)
+ *   3: node_address    (string)
+ */
+export function encodeMsgSubStartSession({ from, id, nodeAddress }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, id),
+    protoString(3, nodeAddress),
+  ]));
+}
+
+// ─── Subscription Management (v3 — from sentinel-go-sdk) ────────────────────
+
+/**
+ * MsgCancelSubscriptionRequest (sentinel.subscription.v3) — cancel a subscription:
+ *   1: from   (string)
+ *   2: id     (uint64, subscription ID)
+ */
+export function encodeMsgCancelSubscription({ from, id }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, id),
+  ]));
+}
+
+/**
+ * MsgRenewSubscriptionRequest (sentinel.subscription.v3) — renew an expiring subscription:
+ *   1: from   (string)
+ *   2: id     (uint64, subscription ID)
+ *   3: denom  (string, default 'udvpn')
+ */
+export function encodeMsgRenewSubscription({ from, id, denom = 'udvpn' }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, id),
+    protoString(3, denom),
+  ]));
+}
+
+/**
+ * MsgShareSubscriptionRequest (sentinel.subscription.v3) — share bandwidth with another address:
+ *   1: from        (string)
+ *   2: id          (uint64, subscription ID)
+ *   3: acc_address (string, recipient sent1... address)
+ *   4: bytes       (int64, bytes to share)
+ */
+export function encodeMsgShareSubscription({ from, id, accAddress, bytes }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, id),
+    protoString(3, accAddress),
+    protoInt64(4, bytes),
+  ]));
+}
+
+/**
+ * MsgUpdateSubscriptionRequest (sentinel.subscription.v3) — update renewal policy:
+ *   1: from                 (string)
+ *   2: id                   (uint64, subscription ID)
+ *   3: renewal_price_policy (int64)
+ */
+export function encodeMsgUpdateSubscription({ from, id, renewalPricePolicy }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, id),
+    protoInt64(3, renewalPricePolicy),
+  ]));
+}
+
+// ─── Session Management (v3) ────────────────────────────────────────────────
+
+/**
+ * MsgUpdateSessionRequest (sentinel.session.v3) — report bandwidth usage:
+ *   1: from            (string)
+ *   2: id              (uint64, session ID)
+ *   3: download_bytes  (int64)
+ *   4: upload_bytes    (int64)
+ *   5: duration        (bytes, protobuf Duration)
+ *   6: signature       (bytes)
+ */
+export function encodeMsgUpdateSession({ from, id, downloadBytes, uploadBytes }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, id),
+    protoInt64(3, downloadBytes),
+    protoInt64(4, uploadBytes),
+  ]));
+}
+
+// ─── Node Operator (v3 — for node operators, NOT consumer apps) ─────────────
+
+/**
+ * MsgRegisterNodeRequest (sentinel.node.v3) — register a new node:
+ *   1: from              (string, sentnode1... address)
+ *   2: gigabyte_prices   (bytes[], Price entries)
+ *   3: hourly_prices     (bytes[], Price entries)
+ *   4: remote_addrs      (string[], IP:port addresses)
+ */
+export function encodeMsgRegisterNode({ from, gigabytePrices = [], hourlyPrices = [], remoteAddrs = [] }) {
+  const parts = [protoString(1, from)];
+  for (const p of gigabytePrices) parts.push(protoEmbedded(2, encodePrice(p)));
+  for (const p of hourlyPrices) parts.push(protoEmbedded(3, encodePrice(p)));
+  for (const addr of remoteAddrs) parts.push(protoString(4, addr));
+  return Uint8Array.from(Buffer.concat(parts));
+}
+
+/**
+ * MsgUpdateNodeDetailsRequest (sentinel.node.v3) — update node details:
+ *   1: from              (string, sentnode1... address)
+ *   2: gigabyte_prices   (bytes[], Price entries)
+ *   3: hourly_prices     (bytes[], Price entries)
+ *   4: remote_addrs      (string[], IP:port addresses)
+ */
+export function encodeMsgUpdateNodeDetails({ from, gigabytePrices = [], hourlyPrices = [], remoteAddrs = [] }) {
+  const parts = [protoString(1, from)];
+  for (const p of gigabytePrices) parts.push(protoEmbedded(2, encodePrice(p)));
+  for (const p of hourlyPrices) parts.push(protoEmbedded(3, encodePrice(p)));
+  for (const addr of remoteAddrs) parts.push(protoString(4, addr));
+  return Uint8Array.from(Buffer.concat(parts));
+}
+
+/**
+ * MsgUpdateNodeStatusRequest (sentinel.node.v3) — activate/deactivate node:
+ *   1: from   (string, sentnode1... address)
+ *   2: status (int64, 1=active, 3=inactive)
+ */
+export function encodeMsgUpdateNodeStatus({ from, status }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, status),
+  ]));
+}
+
+// ─── Plan Management (v3 addition) ──────────────────────────────────────────
+
+/**
+ * MsgUpdatePlanDetailsRequest (sentinel.plan.v3) — update plan details (NEW in v3):
+ *   1: from     (string, sentprov1... address)
+ *   2: id       (uint64, plan ID)
+ *   3: bytes    (string, total bandwidth)
+ *   4: duration (bytes, Duration)
+ *   5: prices   (bytes[], Price entries)
+ */
+export function encodeMsgUpdatePlanDetails({ from, id, bytes, duration, prices = [] }) {
+  const parts = [protoString(1, from), protoInt64(2, id)];
+  if (bytes) parts.push(protoString(3, String(bytes)));
+  if (duration) parts.push(protoEmbedded(4, encodeDuration(
+    typeof duration === 'number' ? { seconds: duration } : duration
+  )));
+  for (const p of prices) parts.push(protoEmbedded(5, encodePrice(p)));
+  return Uint8Array.from(Buffer.concat(parts));
+}
+
+/**
+ * MsgCancelSessionRequest (sentinel.session.v3) — cancel/end a session:
+ *   1: from   (string) — signer address
+ *   2: id     (uint64) — session ID
+ *
+ * NOTE: v3 renamed MsgEndSession to MsgCancelSession and removed the rating field.
+ * The v2 MsgEndRequest had a rating field — v3 does not.
+ */
+export function encodeMsgEndSession({ from, id }) {
+  return Uint8Array.from(Buffer.concat([
+    protoString(1, from),
+    protoInt64(2, id),
+  ]));
+}
+
+/**
+ * Extract session ID from MsgStartSession tx result.
+ * Checks ABCI events for sentinel.node.v3.EventCreateSession.session_id
+ */
+export function extractSessionId(txResult) {
+  // Try ABCI events first
+  for (const event of (txResult.events || [])) {
+    if (/session/i.test(event.type)) {
+      for (const attr of (event.attributes || [])) {
+        const k = typeof attr.key === 'string' ? attr.key
+          : Buffer.from(attr.key, 'base64').toString('utf8');
+        const v = typeof attr.value === 'string' ? attr.value
+          : Buffer.from(attr.value, 'base64').toString('utf8');
+        if (k === 'session_id' || k === 'SessionID' || k === 'id') {
+          const id = BigInt(v.replace(/"/g, ''));
+          if (id > 0n) return id;
+        }
+      }
+    }
+  }
+  // Try rawLog
+  try {
+    const logs = JSON.parse(txResult.rawLog || '[]');
+    for (const log of (Array.isArray(logs) ? logs : [])) {
+      for (const ev of (log.events || [])) {
+        for (const attr of (ev.attributes || [])) {
+          if (attr.key === 'session_id' || attr.key === 'id') {
+            const id = BigInt(String(attr.value).replace(/"/g, ''));
+            if (id > 0n) return id;
+          }
+        }
+      }
+    }
+  } catch { }
+  return null;
+}