wallet

type AddressRequest struct {
	RequestID string `json:"requestId"`
}

type AddressResponse struct {
	RequestID string `json:"requestId"`
	Address   string `json:"address,omitempty"`
	Error     string `json:"error,omitempty"`
}

type ChainID int64

type CompositeWallet struct {
	// contains filtered or unexported fields
}

type ConnectionChecker interface {
	IsConnected() bool
}

type EntSpendingLimiter struct {
	// contains filtered or unexported fields
}

type LocalWallet struct {
	// contains filtered or unexported fields
}

type RPCWallet struct {
	// contains filtered or unexported fields
}

type SignMsgRequest struct {
	RequestID string `json:"requestId"`
	Message   []byte `json:"message"`
}

type SignMsgResponse struct {
	RequestID string `json:"requestId"`
	Signature []byte `json:"signature,omitempty"`
	Error     string `json:"error,omitempty"`
}

type SignTxRequest struct {
	RequestID string `json:"requestId"`
	RawTx     []byte `json:"rawTx"`
}

type SignTxResponse struct {
	RequestID string `json:"requestId"`
	Signature []byte `json:"signature,omitempty"`
	Error     string `json:"error,omitempty"`
}

type SpendingLimiter interface {
	// Check verifies that spending amount is within limits without recording it.
	Check(ctx context.Context, amount *big.Int) error

	// Record records a spent amount for daily tracking.
	Record(ctx context.Context, amount *big.Int) error

	// DailySpent returns the total amount spent today.
	DailySpent(ctx context.Context) (*big.Int, error)

	// DailyRemaining returns the remaining daily budget.
	DailyRemaining(ctx context.Context) (*big.Int, error)

	// IsAutoApprovable checks whether the given amount can be auto-approved
	// without explicit user confirmation, based on the autoApproveBelow threshold
	// and spending limits.
	IsAutoApprovable(ctx context.Context, amount *big.Int) (bool, error)
}

type WalletInfo struct {
	Address string `json:"address"`
	ChainID int64  `json:"chainId"`
	Network string `json:"network"`
}

type WalletProvider interface {
	// Address returns the wallet's public address.
	Address(ctx context.Context) (string, error)

	// Balance returns the native token balance in wei.
	Balance(ctx context.Context) (*big.Int, error)

	// SignTransaction signs a raw transaction and returns the signed bytes.
	SignTransaction(ctx context.Context, rawTx []byte) ([]byte, error)

	// SignMessage signs an arbitrary message and returns the signature.
	SignMessage(ctx context.Context, message []byte) ([]byte, error)

	// PublicKey returns the compressed public key bytes.
	// Used for P2P identity derivation (DID). Private key is never exposed.
	PublicKey(ctx context.Context) ([]byte, error)
}