Skip to content

refactor: Rename sourcehub to remote/vera acp terminology - #5216

Open
shahzadlone wants to merge 6 commits into
sourcenetwork:developfrom
shahzadlone:lone/rename-sourcehub-to-vera-and-remote-acp
Open

refactor: Rename sourcehub to remote/vera acp terminology#5216
shahzadlone wants to merge 6 commits into
sourcenetwork:developfrom
shahzadlone:lone/rename-sourcehub-to-vera-and-remote-acp

Conversation

@shahzadlone

@shahzadlone shahzadlone commented Aug 31, 2026

Copy link
Copy Markdown
Member

Relevant issue(s)

Resolves #5215

Description

  • Rename Sourcehub -> Vera/Remote
  • Rename the ChainID -> LogID to avoid future breaking changes when vera does it.
  • Document in BREAKLOG.md

Todo

  • Update the required ci jobs on github as the workflow job names changed, right before merge.

BREAKING

  • This is a one time exceptional breaking change.

@shahzadlone shahzadlone added this to the DefraDB v1.1 milestone Aug 31, 2026
@shahzadlone
shahzadlone requested a review from a team August 31, 2026 23:58
@shahzadlone shahzadlone self-assigned this Aug 31, 2026
@shahzadlone shahzadlone added refactor This issue specific to or requires *notable* refactoring of existing codebases and components deprecate Indicates something is deprecated. area/acp Related to the acp (access control) system labels Aug 31, 2026
@shahzadlone shahzadlone changed the title refac: Rename sourcehub ACP to remote/vera ACP refac: Rename sourcehub to remote/vera terminology Aug 31, 2026
@shahzadlone
shahzadlone force-pushed the lone/rename-sourcehub-to-vera-and-remote-acp branch from f19711b to 02a01dd Compare September 1, 2026 00:10
@shahzadlone shahzadlone changed the title refac: Rename sourcehub to remote/vera terminology refactor: Rename sourcehub acp to remote/vera acp terminology Sep 1, 2026
@shahzadlone
shahzadlone force-pushed the lone/rename-sourcehub-to-vera-and-remote-acp branch from 02a01dd to 75667e3 Compare September 1, 2026 00:51

@ChrisBQu ChrisBQu left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, but, question: Why did you bundle the version bump with this rename?

I'm not really bothered by it, it clearly has to happen. But it's a different thing?

@shahzadlone

Copy link
Copy Markdown
Member Author

LGTM, but, question: Why did you bundle the version bump with this rename?

I'm not really bothered by it, it clearly has to happen. But it's a different thing?

As mentioned in the PR description those first commits can be ignored, the bump there is necessary and i wanted to see the full thing pass the ci when the bump pr was not merged (those are are cherry picked commits from my outher branch, kind of like manual PR stack). Will remove it in next rebase with develop as its now merged.

@shahzadlone
shahzadlone force-pushed the lone/rename-sourcehub-to-vera-and-remote-acp branch from 75667e3 to e34c461 Compare September 1, 2026 20:41
@shahzadlone shahzadlone changed the title refactor: Rename sourcehub acp to remote/vera acp terminology refactor: Rename sourcehub to remote/vera acp terminology Sep 1, 2026
@codecov

codecov Bot commented Sep 1, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 81.32530% with 31 lines in your changes missing coverage. Please review.
✅ Project coverage is 76.39%. Comparing base (0f7e144) to head (662bcf5).

Files with missing lines Patch % Lines
acp/dac/remote_js.go 0.00% 19 Missing ⚠️
acp/types/types.go 60.00% 4 Missing ⚠️
acp/dac/remote.go 95.12% 2 Missing ⚠️
cli/start.go 75.00% 1 Missing and 1 partial ⚠️
node/acp_dac_remote_js.go 0.00% 2 Missing ⚠️
acp/dac/bridge.go 96.55% 0 Missing and 1 partial ⚠️
node/acp_dac_remote.go 83.33% 1 Missing ⚠️
Additional details and impacted files

Impacted file tree graph

@@             Coverage Diff             @@
##           develop    #5216      +/-   ##
===========================================
- Coverage    76.42%   76.39%   -0.03%     
===========================================
  Files          648      648              
  Lines        51754    51769      +15     
===========================================
- Hits         39551    39548       -3     
- Misses        8876     8889      +13     
- Partials      3327     3332       +5     
Flag Coverage Δ
all-tests 76.39% <81.33%> (-0.03%) ⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines Coverage Δ
acp/dac/local.go 75.00% <100.00%> (+3.57%) ⬆️
acp/dac/remote_object.go 100.00% <100.00%> (ø)
acp/errors.go 72.11% <100.00%> (ø)
acp/nac/nac.go 84.62% <ø> (ø)
acp/validation.go 87.88% <100.00%> (ø)
cbindings/cutils.go 80.77% <100.00%> (ø)
cbindings/node_new.go 85.57% <100.00%> (ø)
cbindings/test_node_options.go 88.48% <100.00%> (ø)
cbindings/utils.go 88.24% <ø> (ø)
cli/client.go 80.00% <100.00%> (ø)
... and 17 more

... and 7 files with indirect coverage changes


Continue to review full report in Codecov by Harness.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 0f7e144...662bcf5. Read the comment docs.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Pin Vera module with a matching published container image, then update the SDK imports and runtime fixtures.

NOTE: this is likely a breaking change as remote ACP connections must target Vera-compatible nodes now.
Replace DefraDB-facing SourceHub terminology with Remote DAC while reserving Vera for the backing repository and network. Rename Go and C APIs, configuration and CLI surfaces, test harnesses, and generated docs.

Note: breaking change becuase the document ACP type source-hub is now remote. Configuration moved from acp.document.sourceHub.* to acp.document.remote.*, --source-hub-address is now --remote-dac-address, and SourceHub Go/C symbols, test targets, and image variables were replaced by Remote DAC or Vera names.
@shahzadlone
shahzadlone force-pushed the lone/rename-sourcehub-to-vera-and-remote-acp branch from e34c461 to c484229 Compare September 3, 2026 02:27
@shahzadlone

shahzadlone commented Sep 3, 2026

Copy link
Copy Markdown
Member Author

@jsimnz Here is the only remaining ChainID reference left, that we will change when Vera updates it in the future.

image

@shahzadlone
shahzadlone requested review from a team and ChrisBQu September 3, 2026 02:31
Adopt the planned Vera LogID terminology across DefraDB Go and C APIs, configuration, and tests while adapting it to Vera’s current ChainID SDK option at the integration boundary.

BREAKING CHANGE: Remote DAC ChainID fields, builders, and configuration are now named LogID. Use RemoteDACLogID, SetLogID, acp.document.remote.LogID, DEFRA_ACP_DOCUMENT_REMOTE_LOGID, and remoteDACLogID.
Document the SourceHub-to-Vera and Remote DAC migration in BREAKLOG.md. Explain how intentional one-off breaking changes outside the standing VERSIONING.md exceptions are communicated and add contributor guidance.
@shahzadlone
shahzadlone force-pushed the lone/rename-sourcehub-to-vera-and-remote-acp branch from c484229 to 662bcf5 Compare September 3, 2026 02:35

@ChrisBQu ChrisBQu left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

// Document ACP
{Path: []string{"DocumentACP", "DocumentACPType"}, Value: "local"},
{Path: []string{"DocumentACP", "Path"}, Value: ""},
{Path: []string{"DocumentACP", "RemoteDACLogID"}, Value: "log-a"},

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

praise: Nice catching that this belongs here, since its beyond a simple find-and-replacee.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/acp Related to the acp (access control) system deprecate Indicates something is deprecated. refactor This issue specific to or requires *notable* refactoring of existing codebases and components

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rename sourcehub ACP to remote/vera ACP

2 participants