writeEncodedBlobToNodes method

Future<Map<int, StorageConfirmation?>> writeEncodedBlobToNodes({
  1. required EncodedBlob encodedBlob,
  2. required CommitteeInfo committee,
  3. required bool deletable,
  4. required String blobObjectId,
  5. Duration nodeTimeout = const Duration(seconds: 30),
  6. int maxConcurrency = 20,
})

Write encoded slivers to all storage nodes in the committee.

Returns a map from node index to confirmation (null if the node failed or did not respond in time).

Mirrors the TS SDK's writeEncodedBlobToNodes().

Implementation

Future<Map<int, StorageConfirmation?>> writeEncodedBlobToNodes({
  required EncodedBlob encodedBlob,
  required CommitteeInfo committee,
  required bool deletable,
  required String blobObjectId,
  Duration nodeTimeout = const Duration(seconds: 30),
  int maxConcurrency = 20,
}) async {
  requireDeletableUpload(deletable);
  _requireDirectCommittee(committee);
  if (maxConcurrency < 1) {
    throw ArgumentError.value(maxConcurrency, 'maxConcurrency');
  }
  if (encodedBlob.primarySlivers.length != committee.numShards ||
      encodedBlob.secondarySlivers.length != committee.numShards) {
    throw ArgumentError(
      'Encoded slivers do not match the active shard count',
    );
  }
  final confirmations = <int, StorageConfirmation?>{};
  final nodes = committee.nodes;
  var failedShards = 0;
  for (var offset = 0; offset < nodes.length; offset += maxConcurrency) {
    final end = (offset + maxConcurrency).clamp(0, nodes.length);
    final results = await Future.wait([
      for (var nodeIndex = offset; nodeIndex < end; nodeIndex++)
        _writeEncodedBlobToNode(
          node: nodes[nodeIndex],
          encodedBlob: encodedBlob,
          committee: committee,
          blobObjectId: blobObjectId,
          timeout: nodeTimeout,
        ).then<MapEntry<int, StorageConfirmation?>>(
          (confirmation) => MapEntry(nodeIndex, confirmation),
          onError: (Object error) {
            logger.debug('Storage node $nodeIndex failed: $error');
            return MapEntry<int, StorageConfirmation?>(nodeIndex, null);
          },
        ),
    ]);
    for (final result in results) {
      confirmations[result.key] = result.value;
      if (result.value == null) {
        failedShards += nodes[result.key].shardIndices.length;
      }
    }
    if (isAboveValidity(failedShards, committee.numShards)) {
      throw NotEnoughBlobConfirmationsError(
        'Storage writes failed for $failedShards/${committee.numShards} shards',
      );
    }
  }
  return confirmations;
}