client

type BindingsClient interface {
	ReadObjectId(ctx context.Context, objectId string) (*suirpcv2.Object, error)
	QueryCoinsByAddress(ctx context.Context, address, coinType string) ([]*suirpcv2.Object, error)
	GetReferenceGasPrice(ctx context.Context) (*big.Int, error)
	SimulatePTB(ctx context.Context, bcsBytes []byte) ([]any, error)
	SendTransaction(ctx context.Context, req *suirpcv2.ExecuteTransactionRequest) (*suirpcv2.ExecuteTransactionResponse, error)
	GetTransactionStatus(ctx context.Context, digest string) (TransactionResult, error)
	FinishPTBAndSend(ctx context.Context, signer *signer.Signer, tx *transaction.Transaction, requestType TransactionRequestType) (*suirpcv2.ExecuteTransactionResponse, error)
}

type CheckpointData struct {
	Checkpoint   *suirpcv2.Checkpoint
	Transactions []*suirpcv2.ExecutedTransaction
}

type EventData struct {
	Id struct {
		TxDigest string `json:"txDigest"`
		EventSeq string `json:"eventSeq"`
	} `json:"id"`
	PackageId         string `json:"packageId"`
	TransactionModule string `json:"transactionModule"`
	Sender            string `json:"sender"`
	Type              struct {
		Address string `json:"address"`
		Module  string `json:"module"`
		Name    string `json:"name"`
	} `json:"type"`
	ParsedJson  any    `json:"parsedJson"`
	Bcs         string `json:"bcs"`
	TimestampMs string `json:"timestampMs"`
}

type EventFilterByMoveEventModule struct {
	Package string `json:"package"`
	Module  string `json:"module"`
	Event   string `json:"event"`
}

type EventId struct {
	TxDigest string `json:"txDigest"`
	EventSeq string `json:"eventSeq"`
}

type EventSelector = EventFilterByMoveEventModule

type FunctionReadResponse struct {
	ReturnValues []any `json:"returnValues"`
}

type GrpcClientConfig struct {
	Target string
	Token  string
	UseTLS bool
}

type MoveCallRequest struct {
	// the transaction signer's Sui address
	Signer string `json:"signer"`
	// the package containing the module and function
	PackageObjectId string `json:"packageObjectId"`
	// the specific module in the package containing the function
	Module string `json:"module"`
	// the function to be called
	Function string `json:"function"`
	// the type arguments to the function
	TypeArguments []any `json:"typeArguments"`
	// the arguments to the function
	Arguments []any `json:"arguments"`
	// gas object to be used in this transaction, node will pick one from the signer's possession if not provided
	Gas uint64 `json:"gas"`
	// the gas budget, the transaction will fail if the gas cost exceed the budget
	GasBudget uint64 `json:"gasBudget"`
}

type ObjectMetadataCache interface {
	GetObjectMetadata(ctx context.Context, objectID string, loader func(context.Context) (*suirpcv2.Object, error)) (*suirpcv2.Object, error)
}

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

type PTBClientConfig struct {
	GrpcTarget            string
	GrpcToken             string
	MaxRetries            *int
	TransactionTimeout    time.Duration
	KeystoreService       loop.Keystore
	MaxConcurrentRequests int64
	// MaxGrpcConnections is the size of the round-robin gRPC connection pool. Zero means use
	// DefaultMaxGrpcConnections.
	MaxGrpcConnections int
	// ObjectCache, when set, caches version-stable object reference metadata to avoid redundant GetObject
	// RPCs on the read hot path. Nil disables object-metadata caching.
	ObjectCache        ObjectMetadataCache
	DefaultRequestType TransactionRequestType
}

type PaginatedEventsResponse struct {
	Data        []EventData `json:"data"`
	NextCursor  string      `json:"nextCursor"`
	HasNextPage bool        `json:"hasNextPage"`
}

type QuerySortOptions struct {
	Descending bool `json:"descending"`
}

type SigFlag byte

type SuiExecutionStatus struct {
	Status string `json:"status"`
	Error  string `json:"error,omitempty"`
}

type SuiPTBClient interface {
	MoveCall(ctx context.Context, req MoveCallRequest) (TxnMetaData, error)
	SendTransaction(ctx context.Context, execRequest *suirpcv2.ExecuteTransactionRequest) (*suirpcv2.ExecuteTransactionResponse, error)
	ReadOwnedObjects(ctx context.Context, ownerAddress string, cursor []byte) ([]*suirpcv2.Object, error)
	ReadFilterOwnedObjectIds(ctx context.Context, ownerAddress string, structType string, cursor []byte) ([]*suirpcv2.Object, error)
	ReadObjectId(ctx context.Context, objectId string) (*suirpcv2.Object, error)
	ReadFunction(ctx context.Context, packageId string, module string, function string, args []any, argTypes []string, typeArgs []string) ([]any, error)
	SimulatePTB(ctx context.Context, bcsBytes []byte) ([]any, error)
	SignAndSendTransaction(ctx context.Context, txBytesRaw string, signerPublicKey []byte) (*suirpcv2.ExecuteTransactionResponse, error)
	QueryEvents(ctx context.Context, filter EventFilterByMoveEventModule, limit *uint, cursor *EventId, sortOptions *QuerySortOptions) (*models.PaginatedEventsResponse, error)
	QueryTransactions(ctx context.Context, fromAddress string, cursor *suirpcv2.Checkpoint, limit *uint64) ([]*suirpcv2.ExecutedTransaction, error)
	GetTransactionStatus(ctx context.Context, digest string) (TransactionResult, error)
	GetCoinsByAddress(ctx context.Context, address string) ([]*suirpcv2.Object, error)
	QueryCoinsByAddress(ctx context.Context, address string, coinType string) ([]*suirpcv2.Object, error)
	EstimateGas(ctx context.Context, tx *transaction.Transaction) (uint64, error)
	GetReferenceGasPrice(ctx context.Context) (*big.Int, error)
	FinishPTBAndSend(ctx context.Context, txnSigner *signer.Signer, tx *transaction.Transaction, requestType TransactionRequestType) (*suirpcv2.ExecuteTransactionResponse, error)
	GetBlockById(ctx context.Context, checkpointDigest string) (*suirpcv2.Checkpoint, error)
	GetLatestEpoch(ctx context.Context) (*suirpcv2.Epoch, error)
	GetLatestCheckpoint(ctx context.Context) (*suirpcv2.Checkpoint, error)
	GetCheckpointData(ctx context.Context, checkpointSequenceNumber uint64) (*CheckpointData, error)
	GetNormalizedModule(ctx context.Context, packageId string, moduleId string) (models.GetNormalizedMoveModuleResponse, error)
	GetMoveModuleFunction(ctx context.Context, packageId string, moduleId string, functionName string) (*suirpcv2.FunctionDescriptor, error)
	GetSUIBalance(ctx context.Context, address string) (*suirpcv2.Balance, error)
	LoadModulePackageIds(ctx context.Context, packageId string, module string) ([]string, error)
	GetLatestPackageId(ctx context.Context, packageId string, module string) (string, error)
	GetCoinMetadata(ctx context.Context, coinType string) (models.CoinMetadataResponse, error)
	GetCache() *cache.Cache
	GetCachedValue(key string) (any, bool)
	SetCachedValue(key string, value any)
	GetCachedValues(keys []string) (map[string]any, bool)
	SetCachedValues(keyValues map[string]any)
	HashTxBytes(txBytes []byte) []byte
	GetCCIPPackageID(ctx context.Context, offRampPackageID string) (string, error)
	GetValuesFromPackageOwnedObjectField(ctx context.Context, packageID string, moduleID string, objectName string, fieldKeys []string) (map[string]string, error)
	GetParentObjectID(ctx context.Context, packageID string, moduleID string, pointerObjectName string) (string, error)
}

type SuiTransactionBlockResponse struct {
	TxDigest      string                    `json:"txDigest"`
	Status        SuiExecutionStatus        `json:"status"`
	Effects       models.SuiEffects         `json:"effects"`
	Events        []models.SuiEventResponse `json:"events,omitempty"`
	Timestamp     uint64                    `json:"timestamp"`
	Height        uint64                    `json:"height"`
	ObjectChanges []models.ObjectChange     `json:"objectChanges,omitempty"`
}

type TransactionBlockOptions struct {
	ShowInput          bool `json:"showInput,omitempty"`
	ShowRawInput       bool `json:"showRawInput,omitempty"`
	ShowEffects        bool `json:"showEffects,omitempty"`
	ShowEvents         bool `json:"showEvents,omitempty"`
	ShowObjectChanges  bool `json:"showObjectChanges,omitempty"`
	ShowBalanceChanges bool `json:"showBalanceChanges,omitempty"`
}

type TransactionBlockRequest struct {
	// BCS serialized transaction data bytes without its type tag, as base-64 encoded string.
	TxBytes string `json:"txBytes"`
	// A list of signatures (`flag || signature || pubkey` bytes, as base-64 encoded string).
	// Signature is committed to the intent message of the transaction data, as base-64 encoded string.
	Signatures []string `json:"signature"`
	// Options for specifying the content to be returned
	Options TransactionBlockOptions `json:"options"`
	// The request type, derived from `SuiTransactionBlockResponseOptions` if None.
	// The optional enumeration values are: `WaitForEffectsCert`, or `WaitForLocalExecution`
	RequestType string `json:"requestType"`
}

type TransactionRequestType string

type TransactionResult struct {
	Status     string `json:"status"`
	Error      string `json:"error"`
	Checkpoint uint64 `json:"checkpoint"`
}

type TxnMetaData struct {
	TxBytes string `json:"txBytes"`
}