feat(client/rpc): auto-generate RPC GO client

.github/workflows/golang-analysis.yml

@@ -61,3 +61,6 @@ jobs:
         uses: protocol/multiple-go-modules@v1.4
         with:
           run: go vet ./...
+      - name: Check generated RPC client
+        if: always()
+        run: go run ./tools/gen-rpc-client -check ./client/rpc/

Rules.mk

@@ -70,6 +70,14 @@ mod_tidy:
 	@find . -name go.mod -execdir $(GOCC) mod tidy \;
 .PHONY: mod_tidy
 
+rpc_client:
+	$(GOCC) run ./tools/gen-rpc-client -output ./client/rpc/
+.PHONY: rpc_client
+
+rpc_client_check:
+	$(GOCC) run ./tools/gen-rpc-client -check ./client/rpc/
+.PHONY: rpc_client_check
+
 coverage: $(COVERAGE)
 .PHONY: coverage
 
@@ -124,6 +132,7 @@ help:
 	@echo '  nofuse       - Build binary with no fuse support'
 	@echo '  install      - Build binary and install into $$GOBIN'
 	@echo '  mod_tidy     - Remove unused dependencies from go.mod files'
+	@echo '  rpc_client   - Regenerate client/rpc/gen_*.go from command definitions'
 #	@echo '  dist_install - TODO: c.f. ./cmd/ipfs/dist/README.md'
 	@echo ''
 	@echo 'CLEANING TARGETS:'
@@ -142,6 +151,7 @@ help:
 	@echo '  test_go_build           - Build kubo for all platforms from .github/build-platforms.yml'
 	@echo '  test_go_lint            - Run golangci-lint'
 	@echo '  test_sharness           - Run sharness tests'
+	@echo '  rpc_client_check        - Verify generated RPC client is up to date'
 	@echo '  coverage                - Collect coverage info from unit tests and sharness'
 	@echo
 .PHONY: help

client/rpc/api.go

@@ -218,42 +218,52 @@ func (api *HttpApi) Request(command string, args ...string) RequestBuilder {
 	}
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.Add, api.Ls).
 func (api *HttpApi) Unixfs() iface.UnixfsAPI {
 	return (*UnixfsAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.BlockGet, api.BlockPut, api.BlockStat).
 func (api *HttpApi) Block() iface.BlockAPI {
 	return (*BlockAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.DagGet, api.DagPut, api.DagStat).
 func (api *HttpApi) Dag() iface.APIDagService {
 	return (*HttpDagServ)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.NamePublish, api.NameResolve).
 func (api *HttpApi) Name() iface.NameAPI {
 	return (*NameAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.KeyGen, api.KeyLs, api.KeyRm).
 func (api *HttpApi) Key() iface.KeyAPI {
 	return (*KeyAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.PinAdd, api.PinLs, api.PinRm).
 func (api *HttpApi) Pin() iface.PinAPI {
 	return (*PinAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.ObjectPatchAddLink, api.ObjectDiff).
 func (api *HttpApi) Object() iface.ObjectAPI {
 	return (*ObjectAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.SwarmPeers, api.SwarmConnect).
 func (api *HttpApi) Swarm() iface.SwarmAPI {
 	return (*SwarmAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.PubsubLs, api.PubsubPub, api.PubsubSub).
 func (api *HttpApi) PubSub() iface.PubSubAPI {
 	return (*PubsubAPI)(api)
 }
 
+// Deprecated: use HttpApi methods directly (e.g., api.RoutingFindpeer, api.RoutingFindprovs).
 func (api *HttpApi) Routing() iface.RoutingAPI {
 	return (*RoutingAPI)(api)
 }

client/rpc/block.go

@@ -14,6 +14,8 @@ import (
 	mh "github.com/multiformats/go-multihash"
 )
 
+// Deprecated: use HttpApi.BlockGet, HttpApi.BlockPut, HttpApi.BlockRm, HttpApi.BlockStat instead.
+// This type implements the legacy CoreAPI BlockAPI interface and will be removed in a future release.
 type BlockAPI HttpApi
 
 type blockStat struct {

client/rpc/dag.go

@@ -14,6 +14,8 @@ import (
 	multicodec "github.com/multiformats/go-multicodec"
 )
 
+// Deprecated: use HttpApi.DagGet, HttpApi.DagPut, HttpApi.DagStat, HttpApi.DagExport, HttpApi.DagImport instead.
+// These types implement the legacy CoreAPI APIDagService interface and will be removed in a future release.
 type (
 	httpNodeAdder        HttpApi
 	HttpDagServ          httpNodeAdder