@blinklabs/dingo 0.7.0 → 0.8.1

package/utxorpc/query.go

@@ -1,311 +0,0 @@
-// Copyright 2025 Blink Labs Software
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-package utxorpc
-
-import (
-	"bytes"
-	"context"
-	"errors"
-	"fmt"
-
-	"connectrpc.com/connect"
-	"github.com/blinklabs-io/gouroboros/ledger"
-	query "github.com/utxorpc/go-codegen/utxorpc/v1alpha/query"
-	"github.com/utxorpc/go-codegen/utxorpc/v1alpha/query/queryconnect"
-)
-
-// queryServiceServer implements the QueryService API
-type queryServiceServer struct {
-	queryconnect.UnimplementedQueryServiceHandler
-	utxorpc *Utxorpc
-}
-
-// ReadParams
-func (s *queryServiceServer) ReadParams(
-	ctx context.Context,
-	req *connect.Request[query.ReadParamsRequest],
-) (*connect.Response[query.ReadParamsResponse], error) {
-	fieldMask := req.Msg.GetFieldMask()
-
-	s.utxorpc.config.Logger.Info(
-		fmt.Sprintf(
-			"Got a ReadParams request with fieldMask %v",
-			fieldMask,
-		),
-	)
-	resp := &query.ReadParamsResponse{}
-
-	protoParams := s.utxorpc.config.LedgerState.GetCurrentPParams()
-	if protoParams == nil {
-		return nil, errors.New("current protocol parameters empty")
-	}
-
-	// Get chain point (slot and hash)
-	point := s.utxorpc.config.LedgerState.Tip().Point
-
-	// Set up response parameters
-	acpc := &query.AnyChainParams_Cardano{
-		Cardano: protoParams.Utxorpc(),
-	}
-	resp.LedgerTip = &query.ChainPoint{
-		Slot: point.Slot,
-		Hash: point.Hash,
-	}
-	resp.Values = &query.AnyChainParams{
-		Params: acpc,
-	}
-	return connect.NewResponse(resp), nil
-}
-
-// ReadUtxos
-func (s *queryServiceServer) ReadUtxos(
-	ctx context.Context,
-	req *connect.Request[query.ReadUtxosRequest],
-) (*connect.Response[query.ReadUtxosResponse], error) {
-	keys := req.Msg.GetKeys() // []*TxoRef
-
-	s.utxorpc.config.Logger.Info(
-		fmt.Sprintf("Got a ReadUtxos request with keys %v", keys),
-	)
-	resp := &query.ReadUtxosResponse{}
-
-	// Get UTxOs from ledger
-	for _, txo := range keys {
-		utxo, err := s.utxorpc.config.LedgerState.UtxoByRef(
-			txo.GetHash(),
-			txo.GetIndex(),
-		)
-		if err != nil {
-			return nil, err
-		}
-		var aud query.AnyUtxoData
-		ret, err := utxo.Decode()
-		if err != nil {
-			return nil, err
-		}
-		if ret == nil {
-			return nil, errors.New("decode returned empty utxo")
-		}
-		audc := query.AnyUtxoData_Cardano{
-			Cardano: ret.Utxorpc(),
-		}
-		aud.NativeBytes = utxo.Cbor
-		aud.TxoRef = txo
-
-		if audc.Cardano.GetDatum() != nil {
-			// Check if Datum.Hash is all zeroes
-			isAllZeroes := true
-			for _, b := range audc.Cardano.GetDatum().GetHash() {
-				if b != 0 {
-					isAllZeroes = false
-					break
-				}
-			}
-			if isAllZeroes {
-				// No actual datum; set Datum to nil to omit it
-				audc.Cardano.Datum = nil
-			}
-		}
-		aud.ParsedState = &audc
-		resp.Items = append(resp.Items, &aud)
-	}
-
-	// Get chain point (slot and hash)
-	point := s.utxorpc.config.LedgerState.Tip().Point
-
-	// Set up response utxos
-	resp.LedgerTip = &query.ChainPoint{
-		Slot: point.Slot,
-		Hash: point.Hash,
-	}
-
-	return connect.NewResponse(resp), nil
-}
-
-// SearchUtxos
-func (s *queryServiceServer) SearchUtxos(
-	ctx context.Context,
-	req *connect.Request[query.SearchUtxosRequest],
-) (*connect.Response[query.SearchUtxosResponse], error) {
-	predicate := req.Msg.GetPredicate()   // *UtxoPredicate
-	startToken := req.Msg.GetStartToken() // string
-	maxItems := req.Msg.GetMaxItems()     // int32
-	fieldMask := req.Msg.GetFieldMask()
-
-	s.utxorpc.config.Logger.Info(
-		fmt.Sprintf(
-			"Got a SearchUtxos request with predicate %v, startToken %s, maxItems %d, and fieldMask %v",
-			predicate,
-			startToken,
-			maxItems,
-			fieldMask,
-		),
-	)
-	resp := &query.SearchUtxosResponse{}
-
-	// TODO: make this optional and create separate code paths
-	if predicate == nil {
-		return nil, fmt.Errorf("empty predicate: %v", predicate)
-	}
-
-	addressPattern := predicate.GetMatch().GetCardano().GetAddress()
-	assetPattern := predicate.GetMatch().GetCardano().GetAsset()
-
-	var addresses []ledger.Address
-	if addressPattern != nil {
-		// Handle Exact Address
-		exactAddressBytes := addressPattern.GetExactAddress()
-		if exactAddressBytes != nil {
-			var addr ledger.Address
-			err := addr.UnmarshalCBOR(exactAddressBytes)
-			if err != nil {
-				return nil, fmt.Errorf(
-					"failed to decode exact address: %w",
-					err,
-				)
-			}
-			addresses = append(addresses, addr)
-		}
-
-		// Handle Payment Part
-		paymentPart := addressPattern.GetPaymentPart()
-		if paymentPart != nil {
-			s.utxorpc.config.Logger.Info("PaymentPart is present, decoding...")
-			var paymentAddr ledger.Address
-			err := paymentAddr.UnmarshalCBOR(paymentPart)
-			if err != nil {
-				return nil, fmt.Errorf("failed to decode payment part: %w", err)
-			}
-			addresses = append(addresses, paymentAddr)
-		}
-
-		// Handle Delegation Part
-		delegationPart := addressPattern.GetDelegationPart()
-		if delegationPart != nil {
-			s.utxorpc.config.Logger.Info(
-				"DelegationPart is present, decoding...",
-			)
-			var delegationAddr ledger.Address
-			err := delegationAddr.UnmarshalCBOR(delegationPart)
-			if err != nil {
-				return nil, fmt.Errorf(
-					"failed to decode delegation part: %w",
-					err,
-				)
-			}
-			addresses = append(addresses, delegationAddr)
-		}
-	}
-
-	// Get UTxOs from ledger
-	for _, address := range addresses {
-		utxos, err := s.utxorpc.config.LedgerState.UtxosByAddress(address)
-		if err != nil {
-			return nil, err
-		}
-		for _, utxo := range utxos {
-			var aud query.AnyUtxoData
-			ret, err := utxo.Decode()
-			if err != nil {
-				return nil, err
-			}
-			if ret == nil {
-				return nil, errors.New("decode returned empty utxo")
-			}
-			audc := query.AnyUtxoData_Cardano{
-				Cardano: ret.Utxorpc(),
-			}
-			aud.NativeBytes = utxo.Cbor
-			aud.TxoRef = &query.TxoRef{
-				Hash:  utxo.TxId,
-				Index: utxo.OutputIdx,
-			}
-			if audc.Cardano.GetDatum() != nil {
-				// Check if Datum.Hash is all zeroes
-				isAllZeroes := true
-				for _, b := range audc.Cardano.GetDatum().GetHash() {
-					if b != 0 {
-						isAllZeroes = false
-						break
-					}
-				}
-				if isAllZeroes {
-					// No actual datum; set Datum to nil to omit it
-					audc.Cardano.Datum = nil
-				}
-			}
-			aud.ParsedState = &audc
-
-			// If AssetPattern is specified, filter based on it
-			if assetPattern != nil {
-				assetFound := false
-				for _, multiasset := range audc.Cardano.GetAssets() {
-					if bytes.Equal(
-						multiasset.GetPolicyId(),
-						assetPattern.GetPolicyId(),
-					) {
-						for _, asset := range multiasset.GetAssets() {
-							if bytes.Equal(
-								asset.GetName(),
-								assetPattern.GetAssetName(),
-							) {
-								assetFound = true
-								break
-							}
-						}
-					}
-					if assetFound {
-						break
-					}
-				}
-
-				// Asset not found; skip this UTxO
-				if !assetFound {
-					continue
-				}
-			}
-			resp.Items = append(resp.Items, &aud)
-		}
-	}
-	// Get chain point (slot and hash)
-	point := s.utxorpc.config.LedgerState.Tip().Point
-
-	resp.LedgerTip = &query.ChainPoint{
-		Slot: point.Slot,
-		Hash: point.Hash,
-	}
-	return connect.NewResponse(resp), nil
-}
-
-// ReadData
-func (s *queryServiceServer) ReadData(
-	ctx context.Context,
-	req *connect.Request[query.ReadDataRequest],
-) (*connect.Response[query.ReadDataResponse], error) {
-	keys := req.Msg.GetKeys() // [][]byte
-	fieldMask := req.Msg.GetFieldMask()
-
-	s.utxorpc.config.Logger.Info(
-		fmt.Sprintf(
-			"Got a ReadData request with keys %v and fieldMask %v",
-			keys,
-			fieldMask,
-		),
-	)
-	resp := &query.ReadDataResponse{}
-
-	// TODO: do the thing once #317 is resolved
-	return connect.NewResponse(resp), nil
-}

package/utxorpc/submit.go

@@ -1,395 +0,0 @@
-// Copyright 2025 Blink Labs Software
-//
-// Licensed under the Apache License, Version 2.0 (the "License");
-// you may not use this file except in compliance with the License.
-// You may obtain a copy of the License at
-//
-//     http://www.apache.org/licenses/LICENSE-2.0
-//
-// Unless required by applicable law or agreed to in writing, software
-// distributed under the License is distributed on an "AS IS" BASIS,
-// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-// See the License for the specific language governing permissions and
-// limitations under the License.
-
-package utxorpc
-
-import (
-	"bytes"
-	"context"
-	"encoding/hex"
-	"errors"
-	"fmt"
-
-	"connectrpc.com/connect"
-	"github.com/blinklabs-io/dingo/event"
-	"github.com/blinklabs-io/dingo/ledger"
-	gledger "github.com/blinklabs-io/gouroboros/ledger"
-	lcommon "github.com/blinklabs-io/gouroboros/ledger/common"
-	cardano "github.com/utxorpc/go-codegen/utxorpc/v1alpha/cardano"
-	submit "github.com/utxorpc/go-codegen/utxorpc/v1alpha/submit"
-	"github.com/utxorpc/go-codegen/utxorpc/v1alpha/submit/submitconnect"
-)
-
-// submitServiceServer implements the SubmitService API
-type submitServiceServer struct {
-	submitconnect.UnimplementedSubmitServiceHandler
-	utxorpc *Utxorpc
-}
-
-// SubmitTx
-func (s *submitServiceServer) SubmitTx(
-	ctx context.Context,
-	req *connect.Request[submit.SubmitTxRequest],
-) (*connect.Response[submit.SubmitTxResponse], error) {
-	txRawList := req.Msg.GetTx() // []*AnyChainTx
-
-	s.utxorpc.config.Logger.Info(
-		fmt.Sprintf(
-			"Got a SubmitTx request with %d transactions",
-			len(txRawList),
-		),
-	)
-	resp := &submit.SubmitTxResponse{}
-
-	// Loop through the transactions and add each to the mempool
-	errorList := make([]error, len(txRawList))
-	hasError := false
-	for i, txi := range txRawList {
-		txRawBytes := txi.GetRaw() // raw bytes
-		txHash := lcommon.Blake2b256Hash(txRawBytes)
-		txType, err := gledger.DetermineTransactionType(txRawBytes)
-		placeholderRef := []byte{}
-		if err != nil {
-			resp.Ref = append(resp.Ref, placeholderRef)
-			errorList[i] = err
-			s.utxorpc.config.Logger.Error(
-				fmt.Sprintf(
-					"failed decoding tx %d: %v",
-					i,
-					err,
-				),
-			)
-			hasError = true
-			continue
-		}
-		// Add transaction to mempool
-		err = s.utxorpc.config.Mempool.AddTransaction(txType, txRawBytes)
-		if err != nil {
-			resp.Ref = append(resp.Ref, placeholderRef)
-			errorList[i] = fmt.Errorf("%s", err.Error())
-			s.utxorpc.config.Logger.Error(
-				fmt.Sprintf(
-					"failed to add tx %s to mempool: %s",
-					txHash.String(),
-					err,
-				),
-			)
-			hasError = true
-			continue
-		}
-		if err != nil {
-			resp.Ref = append(resp.Ref, placeholderRef)
-			errorList[i] = err
-			hasError = true
-			continue
-		}
-		resp.Ref = append(resp.Ref, txHash.Bytes())
-	}
-	if hasError {
-		return connect.NewResponse(resp), fmt.Errorf("%v", errorList)
-	}
-
-	return connect.NewResponse(resp), nil
-}
-
-// WaitForTx
-func (s *submitServiceServer) WaitForTx(
-	ctx context.Context,
-	req *connect.Request[submit.WaitForTxRequest],
-	stream *connect.ServerStream[submit.WaitForTxResponse],
-) error {
-	ref := req.Msg.GetRef() // [][]byte
-
-	s.utxorpc.config.Logger.Info(
-		fmt.Sprintf(
-			"Received WaitForTx request with %d transactions",
-			len(ref),
-		),
-	)
-	s.utxorpc.config.EventBus.SubscribeFunc(
-		ledger.BlockfetchEventType,
-		func(evt event.Event) {
-			e := evt.Data.(ledger.BlockfetchEvent)
-			for _, tx := range e.Block.Transactions() {
-				for _, r := range ref {
-					refHash := hex.EncodeToString(r)
-					// Compare our hashes
-					if refHash == tx.Hash().String() {
-						// Send confirmation response
-						err := stream.Send(&submit.WaitForTxResponse{
-							Ref:   r,
-							Stage: submit.Stage_STAGE_CONFIRMED,
-						})
-						if err != nil {
-							if ctx.Err() != nil {
-								s.utxorpc.config.Logger.Warn(
-									"Client disconnected while sending response",
-									"error",
-									ctx.Err(),
-								)
-								return
-							}
-							s.utxorpc.config.Logger.Error(
-								"Error sending response to client",
-								"transaction_hash", tx.Hash(),
-								"error", err,
-							)
-							return
-						}
-						s.utxorpc.config.Logger.Debug(
-							"Confirmation response sent",
-							"transaction_hash", tx.Hash(),
-						)
-						return // Stop processing after confirming the transaction
-					}
-				}
-			}
-		},
-	)
-	return nil
-}
-
-// ReadMempool
-func (s *submitServiceServer) ReadMempool(
-	ctx context.Context,
-	req *connect.Request[submit.ReadMempoolRequest],
-) (*connect.Response[submit.ReadMempoolResponse], error) {
-	s.utxorpc.config.Logger.Info("Got a ReadMempool request")
-	resp := &submit.ReadMempoolResponse{}
-
-	mempool := []*submit.TxInMempool{}
-	for _, tx := range s.utxorpc.config.Mempool.Transactions() {
-		record := &submit.TxInMempool{
-			NativeBytes: tx.Cbor,
-			Stage:       submit.Stage_STAGE_MEMPOOL,
-		}
-		mempool = append(mempool, record)
-	}
-	resp.Items = mempool
-
-	return connect.NewResponse(resp), nil
-}
-
-// WatchMempool
-func (s *submitServiceServer) WatchMempool(
-	ctx context.Context,
-	req *connect.Request[submit.WatchMempoolRequest],
-	stream *connect.ServerStream[submit.WatchMempoolResponse],
-) error {
-	predicate := req.Msg.GetPredicate() // Predicate
-	fieldMask := req.Msg.GetFieldMask()
-
-	s.utxorpc.config.Logger.Info(
-		fmt.Sprintf(
-			"Got a WatchMempool request with predicate %v and fieldMask %v",
-			predicate,
-			fieldMask,
-		),
-	)
-
-	// Start our forever loop
-	for {
-		// Match against mempool transactions
-		for _, memTx := range s.utxorpc.config.Mempool.Transactions() {
-			txRawBytes := memTx.Cbor
-			txType, err := gledger.DetermineTransactionType(txRawBytes)
-			if err != nil {
-				return err
-			}
-			tx, err := gledger.NewTransactionFromCbor(txType, txRawBytes)
-			if err != nil {
-				return err
-			}
-			cTx := tx.Utxorpc() // *cardano.Tx
-			resp := &submit.WatchMempoolResponse{}
-			record := &submit.TxInMempool{
-				NativeBytes: txRawBytes,
-				Stage:       submit.Stage_STAGE_MEMPOOL,
-			}
-			resp.Tx = record
-			if string(record.GetNativeBytes()) == cTx.String() {
-				if predicate == nil {
-					err := stream.Send(resp)
-					if err != nil {
-						return err
-					}
-				} else {
-					found := false
-					assetFound := false
-
-					// Check Predicate
-					addressPattern := predicate.GetMatch().GetCardano().GetHasAddress()
-					mintAssetPattern := predicate.GetMatch().GetCardano().GetMintsAsset()
-					moveAssetPattern := predicate.GetMatch().GetCardano().GetMovesAsset()
-
-					var addresses []gledger.Address
-					if addressPattern != nil {
-						// Handle Exact Address
-						exactAddressBytes := addressPattern.GetExactAddress()
-						if exactAddressBytes != nil {
-							var addr lcommon.Address
-							err := addr.UnmarshalCBOR(exactAddressBytes)
-							if err != nil {
-								return fmt.Errorf(
-									"failed to decode exact address: %w",
-									err,
-								)
-							}
-							addresses = append(addresses, addr)
-						}
-
-						// Handle Payment Part
-						paymentPart := addressPattern.GetPaymentPart()
-						if paymentPart != nil {
-							s.utxorpc.config.Logger.Info("PaymentPart is present, decoding...")
-							var paymentAddr lcommon.Address
-							err := paymentAddr.UnmarshalCBOR(paymentPart)
-							if err != nil {
-								return fmt.Errorf("failed to decode payment part: %w", err)
-							}
-							addresses = append(addresses, paymentAddr)
-						}
-
-						// Handle Delegation Part
-						delegationPart := addressPattern.GetDelegationPart()
-						if delegationPart != nil {
-							s.utxorpc.config.Logger.Info(
-								"DelegationPart is present, decoding...",
-							)
-							var delegationAddr lcommon.Address
-							err := delegationAddr.UnmarshalCBOR(delegationPart)
-							if err != nil {
-								return fmt.Errorf(
-									"failed to decode delegation part: %w",
-									err,
-								)
-							}
-							addresses = append(addresses, delegationAddr)
-						}
-					}
-
-					var assetPatterns []*cardano.AssetPattern
-					if mintAssetPattern != nil {
-						assetPatterns = append(assetPatterns, mintAssetPattern)
-					}
-					if moveAssetPattern != nil {
-						assetPatterns = append(assetPatterns, moveAssetPattern)
-					}
-
-					// Convert everything to utxos (gledger.TransactionOutput) for matching
-					var utxos []gledger.TransactionOutput
-					utxos = append(tx.Outputs(), tx.CollateralReturn())
-					var inputs []gledger.TransactionInput
-					inputs = append(tx.Inputs(), tx.ReferenceInputs()...)
-					inputs = append(inputs, tx.Collateral()...)
-					for _, input := range inputs {
-						utxo, err := s.utxorpc.config.LedgerState.UtxoByRef(
-							input.Id().Bytes(),
-							input.Index(),
-						)
-						if err != nil {
-							return fmt.Errorf(
-								"failed to look up input: %w",
-								err,
-							)
-						}
-						ret, err := utxo.Decode() // gledger.TransactionOutput
-						if err != nil {
-							return err
-						}
-						if ret == nil {
-							return errors.New("decode returned empty utxo")
-						}
-						utxos = append(utxos, ret)
-					}
-
-					// Check UTxOs for addresses
-					for _, address := range addresses {
-						if found {
-							break
-						}
-						if assetFound {
-							found = true
-							break
-						}
-						for _, utxo := range utxos {
-							if found {
-								break
-							}
-							if assetFound {
-								found = true
-								break
-							}
-							if utxo.Address().String() == address.String() {
-								if found {
-									break
-								}
-								if assetFound {
-									found = true
-									break
-								}
-								// We matched address, check assetPatterns
-								for _, assetPattern := range assetPatterns {
-									// Address found, no assetPattern
-									if assetPattern == nil {
-										found = true
-										break
-									}
-									// Filter on assetPattern
-									for _, policyId := range utxo.Assets().Policies() {
-										if assetFound {
-											found = true
-											break
-										}
-										if bytes.Equal(
-											policyId.Bytes(),
-											assetPattern.GetPolicyId(),
-										) {
-											for _, asset := range utxo.Assets().Assets(
-												policyId,
-											) {
-												if bytes.Equal(
-													asset,
-													assetPattern.GetAssetName(),
-												) {
-													found = true
-													assetFound = true
-													break
-												}
-											}
-										}
-									}
-								}
-								if found {
-									break
-								}
-								// Asset not found; skip this UTxO
-								if !assetFound {
-									continue
-								}
-								found = true
-							}
-						}
-					}
-					if found {
-						err := stream.Send(resp)
-						if err != nil {
-							return err
-						}
-					}
-				}
-			}
-		}
-	}
-}