@sparkdreamnft/sparkdreamjs 0.0.17 → 0.0.18

package/sparkdream/federation/v1/types.d.ts

@@ -1,4 +1,4 @@
-import { Coin, CoinAmino } from "../../../cosmos/base/v1beta1/coin";
+import { ChainIdentity, ChainIdentityAmino } from "../../identity/v1/chain_identity";
 import { BinaryReader, BinaryWriter } from "../../../binary";
 import { DeepPartial } from "../../../helpers";
 export declare enum PeerType {
@@ -6,6 +6,23 @@ export declare enum PeerType {
     PEER_TYPE_SPARK_DREAM = 1,
     PEER_TYPE_ACTIVITYPUB = 2,
     PEER_TYPE_ATPROTO = 3,
+    /**
+     * PEER_TYPE_NOSTR - NOSTR peers are modeled per-relay (one Peer = one relay endpoint).
+     * Uses an off-chain bridge daemon, same accountability model as
+     * ActivityPub/AT Protocol. NOSTR identity (pubkey) is global, so the
+     * same remote_identity may be linked across multiple NOSTR-relay peers.
+     */
+    PEER_TYPE_NOSTR = 4,
+    /**
+     * PEER_TYPE_LENS - Lens peers represent a Lens Chain deployment (zkSync L2 + Avail DA).
+     * Identity is on-chain (wallet address + tokenized handle NFT); the
+     * off-chain bridge daemon is expected to query Lens Chain RPC to
+     * verify NFT ownership before attesting, raising the bar relative to
+     * pure HTTP-signature attestation used for ActivityPub. Future work
+     * (deferred): MsgLinkIdentityViaStateProof for fully on-chain
+     * verification via EVM state proofs.
+     */
+    PEER_TYPE_LENS = 5,
     UNRECOGNIZED = -1
 }
 export declare const PeerTypeAmino: typeof PeerType;
@@ -66,6 +83,37 @@ export declare enum VerificationOutcome {
 export declare const VerificationOutcomeAmino: typeof VerificationOutcome;
 export declare function verificationOutcomeFromJSON(object: any): VerificationOutcome;
 export declare function verificationOutcomeToJSON(object: VerificationOutcome): string;
+/**
+ * PendingVerifierVerdict captures an arbiter-quorum auto-verdict that
+ * hasn't yet been applied (escalation window still open). Drives the
+ * fee-disbursement and slash logic in EndBlocker phase
+ * finalizeAutoResolutions.
+ */
+export declare enum PendingVerifierVerdict {
+    PENDING_VERIFIER_VERDICT_UNSPECIFIED = 0,
+    PENDING_VERIFIER_VERDICT_VERIFIER_RIGHT = 1,
+    PENDING_VERIFIER_VERDICT_VERIFIER_WRONG = 2,
+    UNRECOGNIZED = -1
+}
+export declare const PendingVerifierVerdictAmino: typeof PendingVerifierVerdict;
+export declare function pendingVerifierVerdictFromJSON(object: any): PendingVerifierVerdict;
+export declare function pendingVerifierVerdictToJSON(object: PendingVerifierVerdict): string;
+/**
+ * JuryVerdict is the Phase 2 (human jury) outcome for an escalated
+ * challenge. Submitted via MsgResolveEscalatedChallenge or stamped
+ * automatically on jury deadline expiry (TIMEOUT). Drives the final
+ * fee disbursement, content status, and verifier-side accounting.
+ */
+export declare enum JuryVerdict {
+    JURY_VERDICT_UNSPECIFIED = 0,
+    JURY_VERDICT_CHALLENGE_UPHELD = 1,
+    JURY_VERDICT_CHALLENGE_REJECTED = 2,
+    JURY_VERDICT_CHALLENGE_TIMEOUT = 3,
+    UNRECOGNIZED = -1
+}
+export declare const JuryVerdictAmino: typeof JuryVerdict;
+export declare function juryVerdictFromJSON(object: any): JuryVerdict;
+export declare function juryVerdictToJSON(object: JuryVerdict): string;
 /**
  * Peer represents a federation peer (another Spark Dream chain or external protocol).
  * @name Peer
@@ -83,6 +131,25 @@ export interface Peer {
     registeredBy: string;
     metadata: string;
     removedAt: bigint;
+    /**
+     * controller_group is the x/commons Group policy address that resolves
+     * tier-1 reports against this peer's bridge operators (federation→
+     * service migration, Decision 2). If empty, federation resolves it to
+     * the Operations Committee policy address at MsgRegisterBridge time.
+     * The resolved address is captured on the resulting service.Operator;
+     * changing it later (MsgUpdatePeerController) affects only new
+     * registrations, not existing bridges.
+     */
+    controllerGroup: string;
+    /**
+     * peer_identity carries the chain identity (denoms, display symbols,
+     * chain human name) supplied at peer registration. Used for IBC voucher
+     * metadata pre-registration (see spec §9.2 and x-identity-spec.md) so
+     * wallets render PSPK.ibc instead of ibc/<hash>. Optional for backwards
+     * compatibility with pre-extension peers; populated for PEER_TYPE_SPARK_DREAM
+     * peers registered via MsgRegisterPeer with --peer-identity.
+     */
+    peerIdentity?: ChainIdentity;
 }
 export interface PeerProtoMsg {
     typeUrl: "/sparkdream.federation.v1.Peer";
@@ -105,6 +172,25 @@ export interface PeerAmino {
     registered_by?: string;
     metadata?: string;
     removed_at?: string;
+    /**
+     * controller_group is the x/commons Group policy address that resolves
+     * tier-1 reports against this peer's bridge operators (federation→
+     * service migration, Decision 2). If empty, federation resolves it to
+     * the Operations Committee policy address at MsgRegisterBridge time.
+     * The resolved address is captured on the resulting service.Operator;
+     * changing it later (MsgUpdatePeerController) affects only new
+     * registrations, not existing bridges.
+     */
+    controller_group?: string;
+    /**
+     * peer_identity carries the chain identity (denoms, display symbols,
+     * chain human name) supplied at peer registration. Used for IBC voucher
+     * metadata pre-registration (see spec §9.2 and x-identity-spec.md) so
+     * wallets render PSPK.ibc instead of ibc/<hash>. Optional for backwards
+     * compatibility with pre-extension peers; populated for PEER_TYPE_SPARK_DREAM
+     * peers registered via MsgRegisterPeer with --peer-identity.
+     */
+    peer_identity?: ChainIdentityAmino;
 }
 export interface PeerAminoMsg {
     type: "/sparkdream.federation.v1.Peer";
@@ -175,58 +261,82 @@ export interface PeerPolicyAminoMsg {
     value: PeerPolicyAmino;
 }
 /**
- * BridgeOperator represents an off-chain bridge operator.
- * @name BridgeOperator
+ * BridgeBinding represents the federation-owned binding between a bridge
+ * operator and a peer. Economic state (bond, status, unbonding, slashing
+ * history) lives on the corresponding x/service Operator record keyed
+ * by (address, service_type). This binding holds only federation-
+ * specific data: which peer + protocol + endpoint URL + content stats
+ * + suspended flag (toggled by underfunded/refunded hooks).
+ *
+ * Per Decision 1a of the federation→service migration, one operator
+ * address may hold multiple bindings under the same protocol (one per
+ * peer) backed by a single shared service.Operator and a single shared
+ * bond. Suspending a binding refuses new content submissions but does
+ * not delete it.
+ * @name BridgeBinding
  * @package sparkdream.federation.v1
- * @see proto type: sparkdream.federation.v1.BridgeOperator
+ * @see proto type: sparkdream.federation.v1.BridgeBinding
  */
-export interface BridgeOperator {
+export interface BridgeBinding {
     address: string;
     peerId: string;
     protocol: string;
     endpoint: string;
-    stake: Coin;
     registeredAt: bigint;
-    status: BridgeStatus;
     contentSubmitted: bigint;
-    contentRejected: bigint;
-    slashCount: bigint;
-    revokedAt: bigint;
-    lastSubmissionAt: bigint;
-    unbondingEndTime: bigint;
     contentVerified: bigint;
+    contentRejected: bigint;
     contentUnverified: bigint;
+    lastSubmissionAt: bigint;
+    /**
+     * suspended is set to true by AfterOperatorUnderfunded and cleared
+     * by AfterOperatorReFunded. Federation rejects new content
+     * submissions from suspended bindings.
+     */
+    suspended: boolean;
 }
-export interface BridgeOperatorProtoMsg {
-    typeUrl: "/sparkdream.federation.v1.BridgeOperator";
+export interface BridgeBindingProtoMsg {
+    typeUrl: "/sparkdream.federation.v1.BridgeBinding";
     value: Uint8Array;
 }
 /**
- * BridgeOperator represents an off-chain bridge operator.
- * @name BridgeOperatorAmino
+ * BridgeBinding represents the federation-owned binding between a bridge
+ * operator and a peer. Economic state (bond, status, unbonding, slashing
+ * history) lives on the corresponding x/service Operator record keyed
+ * by (address, service_type). This binding holds only federation-
+ * specific data: which peer + protocol + endpoint URL + content stats
+ * + suspended flag (toggled by underfunded/refunded hooks).
+ *
+ * Per Decision 1a of the federation→service migration, one operator
+ * address may hold multiple bindings under the same protocol (one per
+ * peer) backed by a single shared service.Operator and a single shared
+ * bond. Suspending a binding refuses new content submissions but does
+ * not delete it.
+ * @name BridgeBindingAmino
  * @package sparkdream.federation.v1
- * @see proto type: sparkdream.federation.v1.BridgeOperator
+ * @see proto type: sparkdream.federation.v1.BridgeBinding
  */
-export interface BridgeOperatorAmino {
+export interface BridgeBindingAmino {
     address?: string;
     peer_id?: string;
     protocol?: string;
     endpoint?: string;
-    stake?: CoinAmino;
     registered_at?: string;
-    status?: BridgeStatus;
     content_submitted?: string;
-    content_rejected?: string;
-    slash_count?: string;
-    revoked_at?: string;
-    last_submission_at?: string;
-    unbonding_end_time?: string;
     content_verified?: string;
+    content_rejected?: string;
     content_unverified?: string;
+    last_submission_at?: string;
+    /**
+     * suspended is set to true by AfterOperatorUnderfunded and cleared
+     * by AfterOperatorReFunded. Federation rejects new content
+     * submissions from suspended bindings.
+     */
+    suspended?: boolean;
 }
-export interface BridgeOperatorAminoMsg {
-    type: "/sparkdream.federation.v1.BridgeOperator";
-    value: BridgeOperatorAmino;
+export interface BridgeBindingAminoMsg {
+    type: "/sparkdream.federation.v1.BridgeBinding";
+    value: BridgeBindingAmino;
 }
 /**
  * VerificationRecord tracks a verifier's verification of specific content.
@@ -246,6 +356,23 @@ export interface VerificationRecord {
     priorRejectedChallenges: number;
     lastChallengeResolvedAt: bigint;
     challenger: string;
+    /**
+     * escrowed_challenge_fee is the per-challenge SPARK amount the
+     * challenger escrowed at MsgChallengeVerification time. Snapshotted
+     * because the effective fee escalates with prior_rejected_challenges
+     * (2^N multiplier) — recomputing at resolution time would be fragile.
+     * Used by the auto-resolve path to refund (UPHELD) or split
+     * (REJECTED) the escrow.
+     */
+    escrowedChallengeFee: string;
+    /**
+     * pending_verifier_verdict snapshots the would-be auto-verdict from
+     * the arbiter-quorum branch (UNSPECIFIED until quorum lands, then
+     * VERIFIER_RIGHT or VERIFIER_WRONG). The verdict is applied by the
+     * EndBlocker when the escalation window expires; MsgEscalateChallenge
+     * clears it back to UNSPECIFIED, deferring resolution to the jury path.
+     */
+    pendingVerifierVerdict: PendingVerifierVerdict;
 }
 export interface VerificationRecordProtoMsg {
     typeUrl: "/sparkdream.federation.v1.VerificationRecord";
@@ -269,11 +396,114 @@ export interface VerificationRecordAmino {
     prior_rejected_challenges?: number;
     last_challenge_resolved_at?: string;
     challenger?: string;
+    /**
+     * escrowed_challenge_fee is the per-challenge SPARK amount the
+     * challenger escrowed at MsgChallengeVerification time. Snapshotted
+     * because the effective fee escalates with prior_rejected_challenges
+     * (2^N multiplier) — recomputing at resolution time would be fragile.
+     * Used by the auto-resolve path to refund (UPHELD) or split
+     * (REJECTED) the escrow.
+     */
+    escrowed_challenge_fee?: string;
+    /**
+     * pending_verifier_verdict snapshots the would-be auto-verdict from
+     * the arbiter-quorum branch (UNSPECIFIED until quorum lands, then
+     * VERIFIER_RIGHT or VERIFIER_WRONG). The verdict is applied by the
+     * EndBlocker when the escalation window expires; MsgEscalateChallenge
+     * clears it back to UNSPECIFIED, deferring resolution to the jury path.
+     */
+    pending_verifier_verdict?: PendingVerifierVerdict;
 }
 export interface VerificationRecordAminoMsg {
     type: "/sparkdream.federation.v1.VerificationRecord";
     value: VerificationRecordAmino;
 }
+/**
+ * EscalatedChallenge tracks the Phase 2 (human jury) lifecycle for a
+ * challenge whose Phase 1 auto-verdict was contested via
+ * MsgEscalateChallenge. Operations Committee submits the jury verdict
+ * via MsgResolveEscalatedChallenge; the EndBlocker stamps TIMEOUT on
+ * jury_deadline expiry. Both paths feed the same applyJuryVerdict
+ * helper which disposes of the escrowed challenge_fee + escalation_fee
+ * and (on UPHELD/REJECTED) applies the same verifier-side accounting
+ * as the auto-resolution path.
+ * @name EscalatedChallenge
+ * @package sparkdream.federation.v1
+ * @see proto type: sparkdream.federation.v1.EscalatedChallenge
+ */
+export interface EscalatedChallenge {
+    contentId: bigint;
+    /**
+     * escalator is the address that paid the escalation_fee (challenger
+     * or verifier — either party can escalate within the window).
+     */
+    escalator: string;
+    /**
+     * escrowed_escalation_fee snapshots the SPARK amount escrowed at
+     * escalation time. Refunded to the escalator if the jury verdict
+     * overturns the auto-verdict; burned otherwise.
+     */
+    escrowedEscalationFee: string;
+    /**
+     * auto_verdict_before_escalation snapshots the Phase 1 verdict that
+     * was about to apply. Compared to the jury verdict to determine if
+     * the jury "overturned" the auto-verdict (escalation fee refund).
+     */
+    autoVerdictBeforeEscalation: PendingVerifierVerdict;
+    /**
+     * jury_deadline is the unix-time block-time after which the
+     * EndBlocker stamps TIMEOUT if no MsgResolveEscalatedChallenge has
+     * landed.
+     */
+    juryDeadline: bigint;
+}
+export interface EscalatedChallengeProtoMsg {
+    typeUrl: "/sparkdream.federation.v1.EscalatedChallenge";
+    value: Uint8Array;
+}
+/**
+ * EscalatedChallenge tracks the Phase 2 (human jury) lifecycle for a
+ * challenge whose Phase 1 auto-verdict was contested via
+ * MsgEscalateChallenge. Operations Committee submits the jury verdict
+ * via MsgResolveEscalatedChallenge; the EndBlocker stamps TIMEOUT on
+ * jury_deadline expiry. Both paths feed the same applyJuryVerdict
+ * helper which disposes of the escrowed challenge_fee + escalation_fee
+ * and (on UPHELD/REJECTED) applies the same verifier-side accounting
+ * as the auto-resolution path.
+ * @name EscalatedChallengeAmino
+ * @package sparkdream.federation.v1
+ * @see proto type: sparkdream.federation.v1.EscalatedChallenge
+ */
+export interface EscalatedChallengeAmino {
+    content_id?: string;
+    /**
+     * escalator is the address that paid the escalation_fee (challenger
+     * or verifier — either party can escalate within the window).
+     */
+    escalator?: string;
+    /**
+     * escrowed_escalation_fee snapshots the SPARK amount escrowed at
+     * escalation time. Refunded to the escalator if the jury verdict
+     * overturns the auto-verdict; burned otherwise.
+     */
+    escrowed_escalation_fee?: string;
+    /**
+     * auto_verdict_before_escalation snapshots the Phase 1 verdict that
+     * was about to apply. Compared to the jury verdict to determine if
+     * the jury "overturned" the auto-verdict (escalation fee refund).
+     */
+    auto_verdict_before_escalation?: PendingVerifierVerdict;
+    /**
+     * jury_deadline is the unix-time block-time after which the
+     * EndBlocker stamps TIMEOUT if no MsgResolveEscalatedChallenge has
+     * landed.
+     */
+    jury_deadline?: string;
+}
+export interface EscalatedChallengeAminoMsg {
+    type: "/sparkdream.federation.v1.EscalatedChallenge";
+    value: EscalatedChallengeAmino;
+}
 /**
  * ArbiterHashSubmission stores an arbiter's hash for quorum-based challenge resolution.
  * @name ArbiterHashSubmission
@@ -629,22 +859,33 @@ export declare const PeerPolicy: {
     toProtoMsg(message: PeerPolicy): PeerPolicyProtoMsg;
 };
 /**
- * BridgeOperator represents an off-chain bridge operator.
- * @name BridgeOperator
+ * BridgeBinding represents the federation-owned binding between a bridge
+ * operator and a peer. Economic state (bond, status, unbonding, slashing
+ * history) lives on the corresponding x/service Operator record keyed
+ * by (address, service_type). This binding holds only federation-
+ * specific data: which peer + protocol + endpoint URL + content stats
+ * + suspended flag (toggled by underfunded/refunded hooks).
+ *
+ * Per Decision 1a of the federation→service migration, one operator
+ * address may hold multiple bindings under the same protocol (one per
+ * peer) backed by a single shared service.Operator and a single shared
+ * bond. Suspending a binding refuses new content submissions but does
+ * not delete it.
+ * @name BridgeBinding
  * @package sparkdream.federation.v1
- * @see proto type: sparkdream.federation.v1.BridgeOperator
+ * @see proto type: sparkdream.federation.v1.BridgeBinding
  */
-export declare const BridgeOperator: {
+export declare const BridgeBinding: {
     typeUrl: string;
-    encode(message: BridgeOperator, writer?: BinaryWriter): BinaryWriter;
-    decode(input: BinaryReader | Uint8Array, length?: number): BridgeOperator;
-    fromPartial(object: DeepPartial<BridgeOperator>): BridgeOperator;
-    fromAmino(object: BridgeOperatorAmino): BridgeOperator;
-    toAmino(message: BridgeOperator): BridgeOperatorAmino;
-    fromAminoMsg(object: BridgeOperatorAminoMsg): BridgeOperator;
-    fromProtoMsg(message: BridgeOperatorProtoMsg): BridgeOperator;
-    toProto(message: BridgeOperator): Uint8Array;
-    toProtoMsg(message: BridgeOperator): BridgeOperatorProtoMsg;
+    encode(message: BridgeBinding, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): BridgeBinding;
+    fromPartial(object: DeepPartial<BridgeBinding>): BridgeBinding;
+    fromAmino(object: BridgeBindingAmino): BridgeBinding;
+    toAmino(message: BridgeBinding): BridgeBindingAmino;
+    fromAminoMsg(object: BridgeBindingAminoMsg): BridgeBinding;
+    fromProtoMsg(message: BridgeBindingProtoMsg): BridgeBinding;
+    toProto(message: BridgeBinding): Uint8Array;
+    toProtoMsg(message: BridgeBinding): BridgeBindingProtoMsg;
 };
 /**
  * VerificationRecord tracks a verifier's verification of specific content.
@@ -664,6 +905,31 @@ export declare const VerificationRecord: {
     toProto(message: VerificationRecord): Uint8Array;
     toProtoMsg(message: VerificationRecord): VerificationRecordProtoMsg;
 };
+/**
+ * EscalatedChallenge tracks the Phase 2 (human jury) lifecycle for a
+ * challenge whose Phase 1 auto-verdict was contested via
+ * MsgEscalateChallenge. Operations Committee submits the jury verdict
+ * via MsgResolveEscalatedChallenge; the EndBlocker stamps TIMEOUT on
+ * jury_deadline expiry. Both paths feed the same applyJuryVerdict
+ * helper which disposes of the escrowed challenge_fee + escalation_fee
+ * and (on UPHELD/REJECTED) applies the same verifier-side accounting
+ * as the auto-resolution path.
+ * @name EscalatedChallenge
+ * @package sparkdream.federation.v1
+ * @see proto type: sparkdream.federation.v1.EscalatedChallenge
+ */
+export declare const EscalatedChallenge: {
+    typeUrl: string;
+    encode(message: EscalatedChallenge, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): EscalatedChallenge;
+    fromPartial(object: DeepPartial<EscalatedChallenge>): EscalatedChallenge;
+    fromAmino(object: EscalatedChallengeAmino): EscalatedChallenge;
+    toAmino(message: EscalatedChallenge): EscalatedChallengeAmino;
+    fromAminoMsg(object: EscalatedChallengeAminoMsg): EscalatedChallenge;
+    fromProtoMsg(message: EscalatedChallengeProtoMsg): EscalatedChallenge;
+    toProto(message: EscalatedChallenge): Uint8Array;
+    toProtoMsg(message: EscalatedChallenge): EscalatedChallengeProtoMsg;
+};
 /**
  * ArbiterHashSubmission stores an arbiter's hash for quorum-based challenge resolution.
  * @name ArbiterHashSubmission