Skip to content

Releases: data-preservation-programs/singularity

v1.0.0-RC1

Choose a tag to compare

@github-actions github-actions released this 29 Jun 14:40

What's Changed

  • feat: add f41 PDP deal support to deal tracker by @anjor in #609
  • Wire PDP tracker eth-rpc requirements by @anjor in #612
  • fix piece type inference for non-inline preparations by @parkan in #614
  • Add PDP config/ops layer (PR #5) by @anjor in #613
  • gate container build on green CI to main or release by @parkan in #611
  • skip go generate when codegen inputs unchanged by @parkan in #619
  • upgrade github-actions to v3, enable podman storage cache by @parkan in #620
  • Add PDP scheduling API boundary interfaces by @anjor in #616
  • feat/pdp shovel indexer by @parkan in #617
  • Use writable MariaDB tmpdir in devcontainer scripts by @anjor in #624
  • fix gofmt and make CI check fail on bad formatting by @parkan in #625
  • wire go-synapse signer into keystore (vs go-filsigner), fix Wallet/Actor semantics by @parkan in #622
  • Implement PDP schedule execution path and config wiring by @anjor in #621
  • add Deal.WalletID, decouple from Actor FK by @parkan in #627
  • Add explicit deal type support for schedules by @anjor in #623
  • Wire deal-pusher to on-chain PDP adapter by @anjor in #628
  • simplify wallet-preparation to 1:1, remove random chooser by @parkan in #629
  • fix: skip market epoch-expiry transitions for PDP deals by @anjor in #638
  • fix: clear stale schedule error message after successful completion by @anjor in #637
  • fix PDP quirks by @parkan in #639
  • pdp: propose proof set transfer to sp after filling by @parkan in #640
  • remove stale workflows by @parkan in #641
  • remove --pdp-contract-address flag by @parkan in #642
  • fix flaky TestIntegration_FullResync by @parkan in #645
  • complete key migration code by @parkan in #647
  • add DDO as third deal type by @parkan in #644
  • sane migration path for wallet/actor mapping by @parkan in #650
  • Add SP Pool replication policy mechanism by @anjor in #651
  • docs: add DDO setup and migration guides by @anjor in #648
  • add trustless IPFS gateway, use patched rclone, remove bitswap by @parkan in #646
  • Simplify create-batch: replace --replication with repeatable --deal-type by @anjor in #652
  • Add DDO integration test skeleton and EVM wallet funding helper by @anjor in #653
  • Add --group filter to schedule list by @anjor in #654
  • Add DDO payment token low-balance warnings by @anjor in #656
  • Add DDO E2E integration tests with Anvil fork helpers by @anjor in #655
  • fix non-deterministic piece CID for inline DAG regeneration by @parkan in #657
  • log wallet_assignments migration progress in export-keys by @parkan in #660
  • store keystore-relative names in wallets.key_path by @parkan in #661
  • skip orphan cars in piece metadata lookup by @parkan in #662
  • log healthcheck cleanup cycle at INFO by @parkan in #663
  • index car_blocks.file_id to fix FK cascade scans by @parkan in #665
  • Consolidate FVM precompile test helpers (replaces #659, #664) by @anjor in #667
  • docs: call out wallet funding prerequisite for DDO scheduling by @anjor in #668
  • ddo: clamp term-max via schedule.Duration; reject legacy price flags by @parkan in #666
  • vendor fvm-solidity mocks; convert DDO test off MockAllocationFacet by @parkan in #669
  • devcontainer: add forge alongside anvil by @parkan in #675
  • sol: strip CBOR metadata from mock bytecode by @parkan in #676
  • migrate: check errors in stripWalletAssignmentFKs by @parkan in #674
  • datasetworker: apply MaxInterval default to the right field by @parkan in #672
  • dealtracker: return result.Error, not shadowed outer err by @parkan in #671
  • dataprep: fix err order and %d/string in ListPiecesHandler by @parkan in #673
  • api: fix out-of-bounds on lone-error handler returns by @parkan in #670
  • refactor PDP to use SP-side pull by @parkan in #678
  • datasetworker: skip jobs orphaned by deleted preparations by @parkan in #680

Full Changelog: v0.7.0-RC1...v1.0.0-RC1

v0.7.0-RC1

Choose a tag to compare

@github-actions github-actions released this 04 Feb 15:30

Changelog - v0.7.0

Migration Guide

From v0.5.x / v0.6.x

Database Migration

The database schema has changed significantly. Run the following after upgrading:

singularity admin init

This will auto-migrate the schema. Key changes:

  • Foreign keys changed from CASCADE to SET NULL for performance
  • New indexes added for job and preparation cleanup

admin init is generally cheap to run if schema is healthy so it's advisable to automate as a pre-start script in orchestration, however the initial migration for 0.7.0 may need some time due to index rebuilds so it is advisable to halt other services and run admin init standalone in this one case.

Breaking: MongoDB Removed

MongoDB backend import is no longer supported. If you were using MongoDB (singularity v1):

  1. Export your data from v1
  2. Upgrade to v0.6.0-RC2 and import to PostgreSQL/YugabyteDB (MySQL strongly discouraged, sqlite only for very small deployments)
  3. Then upgrade to v0.7.0

Sequence Reset (PostgreSQL/YugabyteDB)

Automatic: singularity admin init now detects and fixes stale sequences automatically. This handles the common case of importing data with explicit IDs (e.g., from MySQL backup).

Manual: If needed, a standalone script is available at scripts/fix-sequences-after-import.sql.

Piece Type Classification

Automatic: singularity admin init now infers piece_type for CAR files that predate this column, classifying them as data (contains file content) or dag (directory metadata only). This is a no-op if all pieces are already labeled.

Manual: A standalone script is available at scripts/infer_piece_type.sql for inspection or manual runs.

Curio Compatibility (DAG Pieces)

If DAG pieces were rejected by Curio, you will need to regenerate them:

  1. Run singularity admin init to classify existing pieces
  2. Delete the rejected DAG pieces using singularity prep delete-piece
  3. Re-run singularity prep start-daggen on affected preparations to create Curio-compatible pieces

Features

  • prep delete-piece command - Delete specific pieces from a preparation (#602)
  • Small piece padding - Pad very small pieces with literal zeroes for curio compatibility (#595)

Bug Fixes

  • S3 car file renames - Fix car file renames on S3-type remotes (#598)
  • Remote storage padding - Use local tmpfile for padding small pieces on remote/non-appendable storage (#597)
  • Deadlocks resolved - Fix remaining deadlocks in prep deletion and job claiming (#596)
  • Download flags - Harmonize download flags across commands (#599, closes #460)
  • FK re-scanning - Avoid re-scanning known valid foreign keys during cleanup (#601)
  • docker-compose env var - Fix singularity_init container environment variable (#526)
  • prep add-piece CLI - Fix parser bug treating positional args as subcommands; auto-lookup existing pieces by CID for piece consolidation workflows (#607)

Database & Performance

  • Nullable FKs for massive deletes - Use nullable foreign keys and pointers for fast bulk deletion; orphaned objects cleaned up via reaper task in batches (#600)
  • Indexes for FK cleanup - Add indexes on jobs/preps foreign keys for faster operations
  • SKIP LOCKED for job claiming - Prevent deadlocks during concurrent job acquisition
  • Deferred association loading - Load associations after claiming to reduce lock contention

Infrastructure

  • MongoDB removed - Remove legacy MongoDB support (#588)
  • Devcontainer CI - Add devcontainer-based CI workflow with PostgreSQL and MySQL (#586)
  • Distroless runner - Use distroless container image for smaller footprint (#592)
  • Dependency upgrades - Significantly update gorm, boxo, rclone, libp2p, and security packages (#591, #589)
  • Swagger fixes - Remove hardcoded host, dedupe storage type fields, bump go-swagger to v0.33.1 (#605, #606, #608)

Breaking Changes

  • MongoDB backend no longer supported

PRs Included

PR Title
#608 bump go-swagger to v0.33.1
#607 fix add-piece to lookup existing pieces by CID
#606 dedupe fields in storage types codegen
#605 remove hardcoded @host in swagger
#602 feat: add prep delete-piece command
#601 hotfix: avoid re-scanning known valid FKs
#600 give in and use nullable FKs/pointers for massive deletes
#599 harmonize download flags, closes #460
#598 fix: correctly rename cars on S3 type remotes
#597 hotfix: use local tmpfile for padding small pieces
#596 fix remaining deadlocks + prep deletion
#595 Pad very small pieces with literal zeroes
#592 update runner image
#591 improve lotus API test survivability
#589 chore/update
#588 remove legacy mongodb
#586 Devcontainer-based CI flow
#526 fix docker-compose.yml singularity_init container env var
#519 chore: bump version to v0.6.0-RC3
#516 Fix: restore version.json to v0.6.0-RC2

v0.6.0-RC4

Choose a tag to compare

@github-actions github-actions released this 23 Dec 17:23
454b630

What's Changed

Full Changelog: v0.6.0-RC2...v0.6.0-RC4

v0.6.0-RC2

Choose a tag to compare

@github-actions github-actions released this 11 Jun 21:09

🚀 Release Candidate: v0.6.0-R2

This RC introduces support for --min-piece-size, allowing more control over padding behavior for small DAG and data segments, which often led to excessive padding and inefficiencies in deal making and retrieval.

✨ Highlights

  • Add --min-piece-size CLI option (default: 2MiB)
  • Pieces below this size are padded to min, not the full --piece-size
  • Improved chunker behavior for small DAGs and remainder CARs
  • Metadata now includes pieceType (data vs. DAG)

🧪 Intended for Testing

  • Especially relevant for Curio compatibility
  • Allows deal size minimization without breaking existing workflows
  • Final v0.6.0 may include additional patches if needed

📎 Related PRs

  • #479: Feat/allow small pieces
  • #467: Linter/tooling prep for release

🙏 Contributors

Thanks to @parkan and others for implementation.

v0.5.17-RC1

Choose a tag to compare

@github-actions github-actions released this 14 Feb 23:08

Full Changelog: v0.5.17...v0.5.17-RC1

v0.5.17

Choose a tag to compare

@github-actions github-actions released this 14 Feb 22:25

What's Changed

Full Changelog: v0.5.16...v0.5.17

v0.5.16

Choose a tag to compare

@github-actions github-actions released this 27 Jul 04:14

What's Changed

Full Changelog: v0.5.15...v0.5.16

v0.5.15

Choose a tag to compare

@github-actions github-actions released this 24 Jul 18:26

What's Changed

New Contributors

Full Changelog: v0.5.14...v0.5.15

v0.5.14

Choose a tag to compare

@github-actions github-actions released this 29 Apr 18:03

What's Changed

  • Disable metrics reporting by default by @xinaxu in #434

Full Changelog: v0.5.13...v0.5.14

v0.5.13

Choose a tag to compare

@github-actions github-actions released this 07 Mar 22:51

What's Changed

  • Update doc about singularity download server by @xinaxu in #430
  • Allow unknown remote object size by @xinaxu in #431

Full Changelog: v0.5.12...v0.5.13