Skip to content

sumdb

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

sumdb

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
cmd
cmd
 
 
README.md
README.md
 
 
proxy.go
proxy.go
 
 
proxy_test.go
proxy_test.go
 
 

README.md

SumDB to tlog-tiles proxy

This is a proxy that serves the Go SumDB with a tlog-tiles API. This allows tooling written for the tlog-tiles API to be used with the SumDB, even though its API is slightly different.

Running

Basic Usage

go run ./sumdb/cmd/proxy.go --listen=":8089"

Advanced Usage

go run ./sumdb/cmd/proxy.go --witnesses 2 --index ./woodpecker-web/index.html

This runs a version with a Web UI that also fetches witnesses confirming the log has evolved consistently. To see the web UI, simply open http://localhost:8089/.

Using

Any valid tlog-tiles API paths sent to the listen address will be routed to the SumDB proxy. Paths will be changed as necessary, and leaf data returned will be rewritten to comply with the tlog-tiles spec.

For example, to run Tessera's tlog-tiles fsck tool against the log to confirm integrity:

# Put the SumDB public key in a file so that fsck can read it.
echo sum.golang.org+033de0ae+Ac4zctda0e5eza+HJyk9SxEdh+s3Ux18htTTAD8OuAn8 > ~/.go.sum.vkey

# Run the fsck tool against the proxy.
go run github.com/transparency-dev/tessera/cmd/fsck@main \
  --storage_url=http://localhost:8089/ \
  --public_key ~/.go.sum.vkey \
  --origin "go.sum database tree"