txid [%s]: unsuppored transaction. Paginated queries are sup

Error message

txid [%s]: unsuppored transaction. Paginated queries are supported only in a read-only transaction

What it means

Returned by checkBeforePaginatedQueries when a paginated range-scan or query is attempted after the simulator has performed a write. Paginated queries are only permitted in read-only simulations; mixing them with writes is rejected to keep results consistent.

Source

Thrown at core/ledger/kvledger/txmgmt/txmgr/tx_simulator.go:252

func (s *txSimulator) checkBeforePvtdataQueries() error {
	if s.writePerformed {
		return errors.Errorf("txid [%s]: unsuppored transaction. Queries on pvt data is supported only in a read-only transaction", s.txid)
	}
	s.pvtdataQueriesPerformed = true
	return nil
}

func (s *txSimulator) checkPvtdataQueryPerformed() error {
	if s.pvtdataQueriesPerformed {
		return errors.Errorf("txid [%s]: unsuppored transaction. Transaction has already performed queries on pvt data. Writes are not allowed", s.txid)
	}
	return nil
}

func (s *txSimulator) checkBeforePaginatedQueries() error {
	if s.writePerformed {
		return errors.Errorf("txid [%s]: unsuppored transaction. Paginated queries are supported only in a read-only transaction", s.txid)
	}
	s.paginatedQueriesPerformed = true
	return nil
}

func (s *txSimulator) checkPaginatedQueryPerformed() error {
	if s.paginatedQueriesPerformed {
		return errors.Errorf("txid [%s]: unsuppored transaction. Transaction has already performed a paginated query. Writes are not allowed", s.txid)
	}
	return nil
}

View on GitHub (pinned to 2736b63f8f)

Solutions

Issue paginated queries before any writes, or in a separate read-only transaction

Defensive patterns

Strategy: validation

When it happens

Trigger: Thrown at core/ledger/kvledger/txmgmt/txmgr/tx_simulator.go:252 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of hyperledger/fabric@2736b63f8f (2026-09-04). Data as JSON: /api/errors/af46e5cdaea0260d. Report an issue: GitHub.