From 67c65ae9f505ddc10ef5abe1dca1724b51488dd2 Mon Sep 17 00:00:00 2001 From: Eric Myhre Date: Mon, 25 Oct 2021 20:26:54 +0200 Subject: [PATCH 01/14] storage: many more adapters; a new filesystem storage implementation; benchmark helper functions; and actual benchmark tables, runnable, which compare several storage implementations. --- storage/benchmarks/README.md | 40 + storage/benchmarks/go.mod | 13 + storage/benchmarks/go.sum | 122 +++ storage/benchmarks/storageBenchmarks_test.go | 93 +++ storage/bsadapter/README.md | 48 ++ storage/bsadapter/bsadapter.go | 120 +++ storage/bsadapter/go.mod | 20 + storage/bsadapter/go.sum | 191 +++++ storage/bsrvadapter/README.md | 58 ++ storage/bsrvadapter/bsrvadapter.go | 129 +++ storage/bsrvadapter/go.mod | 9 + storage/bsrvadapter/go.sum | 826 +++++++++++++++++++ storage/dsadapter/README.md | 37 + storage/dsadapter/dsadapter.go | 3 + storage/fsstore/fsstore.go | 237 ++++++ storage/tests/benchmarks.go | 59 ++ storage/tests/generators.go | 26 + 17 files changed, 2031 insertions(+) create mode 100644 storage/benchmarks/README.md create mode 100644 storage/benchmarks/go.mod create mode 100644 storage/benchmarks/go.sum create mode 100644 storage/benchmarks/storageBenchmarks_test.go create mode 100644 storage/bsadapter/README.md create mode 100644 storage/bsadapter/bsadapter.go create mode 100644 storage/bsadapter/go.mod create mode 100644 storage/bsadapter/go.sum create mode 100644 storage/bsrvadapter/README.md create mode 100644 storage/bsrvadapter/bsrvadapter.go create mode 100644 storage/bsrvadapter/go.mod create mode 100644 storage/bsrvadapter/go.sum create mode 100644 storage/fsstore/fsstore.go create mode 100644 storage/tests/benchmarks.go create mode 100644 storage/tests/generators.go diff --git a/storage/benchmarks/README.md b/storage/benchmarks/README.md new file mode 100644 index 00000000..d37eb9d7 --- /dev/null +++ b/storage/benchmarks/README.md @@ -0,0 +1,40 @@ +benchmarks +========== + +This is a small module that pulls in a bunch of storage implementations, +as well as legacy implementations via the adapter modules, +and benchmarks all of them on the same benchmarks. + +There's no reason to import this code, +so the go.mod file uses relative paths shamelessly. +(You can create your own benchmarks using the code in `../tests`, +which contains most of the engine; this package is just tables of setup.) + + +What variations do the benchmarks exercise? +------------------------------------------ + +- the various storage implementations! + - in some cases: variations of parameters to individual storage implementations. (TODO) +- puts and gets. (TODO: currently only puts.) +- various distributions of data size. (TODO) +- block mode vs streaming mode. (TODO) +- end-to-end use via linksystem with small cbor objects. (TODO) + - (this measures a lot of things that aren't to do with the storage itself -- but is useful to contextualize things.) + +Running the benchmarks on variations in hardware and filesystem may also be important! +Many of these storage systems use the disk in some way. + + +Why is the module structured like this? +---------------------------------------- + +See similar discussion in the `../dsadapter` module. + +Long story short: to keep legacy dependencies from appearing in modern dependency trees, +even though we want to test them, and want to do it without spawning yet more git repos. + +It may be worth pulling this out into a new git repo in the future, +especially if we want to add more and more implementations to what we benchmark, +or develop additional tools for deploying the benchmark on varying hardware, etc. +For now, it incubates here. diff --git a/storage/benchmarks/go.mod b/storage/benchmarks/go.mod new file mode 100644 index 00000000..95ae1439 --- /dev/null +++ b/storage/benchmarks/go.mod @@ -0,0 +1,13 @@ +module github.com/ipld/go-ipld-prime/storage/benchmarks + +go 1.16 + +replace github.com/ipld/go-ipld-prime => ../.. + +replace github.com/ipld/go-ipld-prime/storage/dsadapter => ../dsadapter + +require ( + github.com/ipfs/go-ds-flatfs v0.4.5 + github.com/ipld/go-ipld-prime v0.12.3 + github.com/ipld/go-ipld-prime/storage/dsadapter v0.0.0-20211022093231-ebf675a9bd6d +) diff --git a/storage/benchmarks/go.sum b/storage/benchmarks/go.sum new file mode 100644 index 00000000..52b162d2 --- /dev/null +++ b/storage/benchmarks/go.sum @@ -0,0 +1,122 @@ +github.com/BurntSushi/toml v0.3.1 h1:WXkYYl6Yr3qBf1K79EBnL4mak0OimBfB0XUf9Vl28OQ= +github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= +github.com/alexbrainman/goissue34681 v0.0.0-20191006012335-3fc7a47baff5 h1:iW0a5ljuFxkLGPNem5Ui+KBjFJzKg4Fv2fnxe4dvzpM= +github.com/alexbrainman/goissue34681 v0.0.0-20191006012335-3fc7a47baff5/go.mod h1:Y2QMoi1vgtOIfc+6DhrMOGkLoGzqSV2rKp4Sm+opsyA= +github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/frankban/quicktest v1.14.0/go.mod h1:NeW+ay9A/U67EYXNFA1nPE8e/tnQv/09mUdL/ijj8og= +github.com/gogo/protobuf v1.2.1 h1:/s5zKNz0uPFCZ5hddgPdo2TK2TVrUNMn0OOX8/aZMTE= +github.com/gogo/protobuf v1.2.1/go.mod h1:hp+jE20tsWTFYpLwKvXlhS1hjn+gTNwPg2I6zVXpSg4= +github.com/google/go-cmp v0.5.6/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI= +github.com/google/uuid v1.1.1 h1:Gkbcsh/GbpXz7lPftLA3P6TYMwjCLYm83jiFQZF/3gY= +github.com/google/uuid v1.1.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/gopherjs/gopherjs v0.0.0-20181017120253-0766667cb4d1/go.mod h1:wJfORRmW1u3UXTncJ5qlYoELFm8eSnnEO6hX4iZ3EWY= +github.com/ipfs/go-cid v0.0.4/go.mod h1:4LLaPOQwmk5z9LBgQnpkivrx8BJjUyGwTXCd5Xfj6+M= +github.com/ipfs/go-datastore v0.4.4/go.mod h1:SX/xMIKoCszPqp+z9JhPYCmoOoXTvaa13XEbGtsFUhA= +github.com/ipfs/go-datastore v0.4.6 h1:zU2cmweykxJ+ziXnA2cPtsLe8rdR/vrthOipLPuf6kc= +github.com/ipfs/go-datastore v0.4.6/go.mod h1:XSipLSc64rFKSFRFGo1ecQl+WhYce3K7frtpHkyPFUc= +github.com/ipfs/go-detect-race v0.0.1 h1:qX/xay2W3E4Q1U7d9lNs1sU9nvguX0a7319XbyQ6cOk= +github.com/ipfs/go-detect-race v0.0.1/go.mod h1:8BNT7shDZPo99Q74BpGMK+4D8Mn4j46UU0LZ723meps= +github.com/ipfs/go-ds-flatfs v0.4.5 h1:4QceuKEbH+HVZ2ZommstJMi3o3II+dWS3IhLaD7IGHs= +github.com/ipfs/go-ds-flatfs v0.4.5/go.mod h1:e4TesLyZoA8k1gV/yCuBTnt2PJtypn4XUlB5n8KQMZY= +github.com/ipfs/go-ipfs-delay v0.0.0-20181109222059-70721b86a9a8/go.mod h1:8SP1YXK1M1kXuc4KJZINY3TQQ03J2rwBG9QfXmbRPrw= +github.com/ipfs/go-log v1.0.3 h1:Gg7SUYSZ7BrqaKMwM+hRgcAkKv4QLfzP4XPQt5Sx/OI= +github.com/ipfs/go-log v1.0.3/go.mod h1:OsLySYkwIbiSUR/yBTdv1qPtcE4FW3WPWk/ewz9Ru+A= +github.com/ipfs/go-log/v2 v2.0.3 h1:Q2gXcBoCALyLN/pUQlz1qgu0x3uFV6FzP9oXhpfyJpc= +github.com/ipfs/go-log/v2 v2.0.3/go.mod h1:O7P1lJt27vWHhOwQmcFEvlmo49ry2VY2+JfBWFaa9+0= +github.com/jbenet/go-cienv v0.1.0/go.mod h1:TqNnHUmJgXau0nCzC7kXWeotg3J9W34CUv5Djy1+FlA= +github.com/jbenet/goprocess v0.0.0-20160826012719-b497e2f366b8/go.mod h1:Ly/wlsjFq/qrU3Rar62tu1gASgGw6chQbSh/XgIIXCY= +github.com/jbenet/goprocess v0.1.4 h1:DRGOFReOMqqDNXwW70QkacFW0YN9QnwLV0Vqk+3oU0o= +github.com/jbenet/goprocess v0.1.4/go.mod h1:5yspPrukOVuOLORacaBi858NqyClJPQxYZlqdZVfqY4= +github.com/jtolds/gls v4.20.0+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU= +github.com/kisielk/errcheck v1.1.0/go.mod h1:EZBBE59ingxPouuu3KfxchcWSUPOHkagtvWXihfKN4Q= +github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck= +github.com/klauspost/cpuid/v2 v2.0.4/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo= +github.com/kr/pretty v0.2.0/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI= +github.com/kr/pretty v0.3.0 h1:WgNl7dwNpEZ6jJ9k1snq4pZsg7DOEN8hP9Xw0Tsjwk0= +github.com/kr/pretty v0.3.0/go.mod h1:640gp4NfQd8pI5XOwp5fnNeVWj67G7CFk/SaSQn7NBk= +github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= +github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= +github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY= +github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE= +github.com/minio/blake2b-simd v0.0.0-20160723061019-3f5f724cb5b1/go.mod h1:pD8RvIylQ358TN4wwqatJ8rNavkEINozVn9DtGI3dfQ= +github.com/minio/sha256-simd v0.1.1-0.20190913151208-6de447530771/go.mod h1:B5e1o+1/KgNmWrSQK08Y6Z1Vb5pwIktudl0J58iy0KM= +github.com/minio/sha256-simd v1.0.0/go.mod h1:OuYzVNI5vcoYIAmbIvHPl3N3jUzVedXbKy5RFepssQM= +github.com/mr-tron/base58 v1.1.0/go.mod h1:xcD2VGqlgYjBdcBLw+TuYLr8afG+Hj8g2eTVqeSzSU8= +github.com/mr-tron/base58 v1.1.2/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/mr-tron/base58 v1.2.0/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/multiformats/go-base32 v0.0.3/go.mod h1:pLiuGC8y0QR3Ue4Zug5UzK9LjgbkL8NSQj0zQ5Nz/AA= +github.com/multiformats/go-multibase v0.0.1/go.mod h1:bja2MqRZ3ggyXtZSEDKpl0uO/gviWFaSteVbWT51qgs= +github.com/multiformats/go-multicodec v0.3.0/go.mod h1:qGGaQmioCDh+TeFOnxrbU0DaIPw8yFgAZgFG0V7p1qQ= +github.com/multiformats/go-multihash v0.0.10/go.mod h1:YSLudS+Pi8NHE7o6tb3D8vrpKa63epEDmG8nTduyAew= +github.com/multiformats/go-multihash v0.0.15/go.mod h1:D6aZrWNLFTV/ynMpKsNtB40mJzmCl4jb1alC0OvHiHg= +github.com/multiformats/go-varint v0.0.6/go.mod h1:3Ls8CIEsrijN6+B7PbrXRPxHRPuXSrVKRY101jdMZYE= +github.com/opentracing/opentracing-go v1.1.0 h1:pWlfV3Bxv7k65HYwkikxat0+s3pV4bsqf19k25Ur8rU= +github.com/opentracing/opentracing-go v1.1.0/go.mod h1:UkNAQd3GIcIGf0SeVgPpRdFStlNbqXla1AfSYxPUl2o= +github.com/pkg/errors v0.8.1 h1:iURUrRGxPUNPdy5/HRSm+Yj6okJ6UtLINN0Q9M4+h3I= +github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/polydawn/refmt v0.0.0-20201211092308-30ac6d18308e/go.mod h1:uIp+gprXxxrWSjjklXD+mN4wed/tMfjMMmN/9+JsA9o= +github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4= +github.com/rogpeppe/go-internal v1.6.1 h1:/FiVV8dS/e+YqF2JvO3yXRFbBLTIuSDkuC7aBOAvL+k= +github.com/rogpeppe/go-internal v1.6.1/go.mod h1:xXDCJY+GAPziupqXw64V24skbSoqbTEfhy4qGm1nDQc= +github.com/smartystreets/assertions v0.0.0-20180927180507-b2de0cb4f26d/go.mod h1:OnSkiWE9lh6wB0YB77sQom3nweQdgAjqCqsofrRNTgc= +github.com/smartystreets/goconvey v1.6.4/go.mod h1:syvi0/a8iFYH4r/RixwvyeAJjdLS9QV7WQ/tjFTllLA= +github.com/spaolacci/murmur3 v1.1.0/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2Kzu9HwQUA= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.4.0 h1:2E4SXV/wtOkTonXsotYi4li6zVWxYlZuYNCXe9XRJyk= +github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= +github.com/warpfork/go-testmark v0.3.0/go.mod h1:jhEf8FVxd+F17juRubpmut64NEG6I2rgkUhlcqqXwE0= +github.com/warpfork/go-wish v0.0.0-20200122115046-b9ea61034e4a/go.mod h1:x6AKhvSSexNrVSrViXSHUEbICjmGXhtgABaHIySUSGw= +go.uber.org/atomic v1.4.0/go.mod h1:gD2HeocX3+yG+ygLZcrzQJaqmWj9AIm7n08wl/qW/PE= +go.uber.org/atomic v1.6.0 h1:Ezj3JGmsOnG1MoRWQkPBsKLe9DwWD9QeXzTRzzldNVk= +go.uber.org/atomic v1.6.0/go.mod h1:sABNBOSYdrvTF6hTgEIbc7YasKWGhgEQZyfxyTvoXHQ= +go.uber.org/multierr v1.1.0/go.mod h1:wR5kodmAFQ0UK8QlbwjlSNy0Z68gJhDJUG5sjR94q/0= +go.uber.org/multierr v1.5.0 h1:KCa4XfM8CWFCpxXRGok+Q0SS/0XBhMDbHHGABQLvD2A= +go.uber.org/multierr v1.5.0/go.mod h1:FeouvMocqHpRaaGuG9EjoKcStLC43Zu/fmqdUMPcKYU= +go.uber.org/tools v0.0.0-20190618225709-2cfd321de3ee h1:0mgffUl7nfd+FpvXMVz4IDEaUSmT1ysygQC7qYo7sG4= +go.uber.org/tools v0.0.0-20190618225709-2cfd321de3ee/go.mod h1:vJERXedbb3MVM5f9Ejo0C68/HhF8uaILCdgjnY+goOA= +go.uber.org/zap v1.10.0 h1:ORx85nbTijNz8ljznvCMR1ZBIPKFn3jQrag10X2AsuM= +go.uber.org/zap v1.10.0/go.mod h1:vwi/ZaCAaUcBkycHslxD9B2zi4UTXhF60s6SWpuDF0Q= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20190510104115-cbcb75029529/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20190611184440-5c40567a22f8/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20210220033148-5ea612d1eb83/go.mod h1:jdWPYTVW3xRLrWPugEBEK3UY2ZEsg3UU495nc5E+M+I= +golang.org/x/lint v0.0.0-20190930215403-16217165b5de h1:5hukYrvBGR8/eNkX5mdUezrA6JiaEZDtJb9Ei+1LlBs= +golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= +golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc= +golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210309074719-68d13333faf2/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/term v0.0.0-20201117132131-f5c789dd3221/go.mod h1:Nr5EML6q2oocZ2LXRh80K7BxOlk5/8JxuGnuhpl+muw= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/tools v0.0.0-20180221164845-07fd8470d635/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= +golang.org/x/tools v0.0.0-20190328211700-ab21143f2384/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= +golang.org/x/tools v0.0.0-20190621195816-6e04913cbbac/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= +golang.org/x/tools v0.0.0-20191029041327-9cc4af7d6b2c/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20191029190741-b9c20aec41a5 h1:hKsoRgsbwY1NafxrwTs+k64bikrLBkAgPir1TNCj3Zs= +golang.org/x/tools v0.0.0-20191029190741-b9c20aec41a5/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15 h1:YR8cESwS4TdDjEe65xsg0ogRM/Nc3DYOhEAlW+xobZo= +gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI= +gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY= +gopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ= +honnef.co/go/tools v0.0.1-2019.2.3 h1:3JgtbtFHMiCmsznwGVTUWbgGov+pVqnlf1dEJTNAXeM= +honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg= diff --git a/storage/benchmarks/storageBenchmarks_test.go b/storage/benchmarks/storageBenchmarks_test.go new file mode 100644 index 00000000..22aa4752 --- /dev/null +++ b/storage/benchmarks/storageBenchmarks_test.go @@ -0,0 +1,93 @@ +package benchmarks + +import ( + "encoding/base32" + "fmt" + "io/ioutil" + "os" + "testing" + + flatfs "github.com/ipfs/go-ds-flatfs" + "github.com/ipld/go-ipld-prime/storage" + "github.com/ipld/go-ipld-prime/storage/dsadapter" + "github.com/ipld/go-ipld-prime/storage/fsstore" + "github.com/ipld/go-ipld-prime/storage/memstore" + "github.com/ipld/go-ipld-prime/storage/tests" +) + +func BenchmarkPut(b *testing.B) { + // - memstore + // - dsadapter with flatfs + // - bsrvadapter wrapped around that (todo) + // - fsstore + tt := []struct { + storeName string // used in test name + storeConstructor func() storage.WritableStorage + }{{ + storeName: "memstore", + storeConstructor: func() storage.WritableStorage { + return &memstore.Store{} + }, + }, { + storeName: "dsadapter-flatfs-base32-defaultshard", + storeConstructor: func() storage.WritableStorage { + shardFn, err := flatfs.ParseShardFunc("/repo/flatfs/shard/v1/next-to-last/3") + if err != nil { + panic(err) + } + ds, err := flatfs.CreateOrOpen(".", shardFn, false) + if err != nil { + panic(err) + } + return &dsadapter.Adapter{ + Wrapped: ds, + EscapingFunc: func(raw string) string { + return base32.StdEncoding.WithPadding(base32.NoPadding).EncodeToString([]byte(raw)) + }, + } + }, + }, { + storeName: "fsstore-base32-defaultshard", + storeConstructor: func() storage.WritableStorage { + store := &fsstore.Store{} + if err := store.InitDefaults("."); err != nil { + panic(err) + } + return store + }, + }} + for _, ttr := range tt { + b.Run(ttr.storeName, func(b *testing.B) { + for _, scale := range []int{ + 1 << 8, // probably too small to be useful; b.N will always be much bigger than this. + 1 << 12, + 1 << 16, + //1 << 20, // already getting too big to fit the setup phase into the default benchmark time windows when using disk storage. + //1 << 24, + } { + b.Run(fmt.Sprintf("scale=%d", scale), func(b *testing.B) { + // Make a tempdir. Change cwd to it. + // We'll assume the storage system, if it needs filesystem, can use the cwd. + dir, err := ioutil.TempDir("", "storagebench") + if err != nil { + panic(err) + } + defer os.RemoveAll(dir) + retreat, err := os.Getwd() + if err != nil { + panic(err) + } + defer os.Chdir(retreat) + if err := os.Chdir(dir); err != nil { + panic(err) + } + + // Create the store, and put it to work! + store := ttr.storeConstructor() + gen := tests.NewCounterGen(1000000) // Use a large enough number that any sharding function kicks in (e.g. the b10 string is >=7 chars). + tests.BenchPut(b, store, gen, scale) + }) + } + }) + } +} diff --git a/storage/bsadapter/README.md b/storage/bsadapter/README.md new file mode 100644 index 00000000..201291c9 --- /dev/null +++ b/storage/bsadapter/README.md @@ -0,0 +1,48 @@ +bsadapter +========= + +The `bsadapter` package/module is a small piece of glue code to connect +the `github.com/ipfs/go-blockstore` package, and packages implementing its interfaces, +forward into the `go-ipld-prime/storage` interfaces. + + +Why structured like this? +------------------------- + +See similar discussion in the `../dsadapter` module. + + +Which of `dsadapter` vs `bsadapter` vs `bsrvadapter` should I use? +------------------------------------------------------------------ + +None of them, ideally. +A direct implementation of the storage APIs will almost certainly be able to perform better than any of these adapters. + +Failing that: use the adapter matching whatever you've got on hand in your code. + +There is no correct choice. + +dsadapter suffers avoidable excessive allocs in processing its key type, +due to choices in the interior of `github.com/ipfs/go-datastore`. +It is also unable to support streaming operation, should you desire it. + +bsadapter and bsrvadapter both also suffer overhead due to their key type, +because they require a transformation back from the plain binary strings used in the storage API to the concrete go-cid type, +which spends some avoidable CPU time (and also, at present, causes avoidable allocs because of some interesting absenses in `go-cid`). +Additionally, they suffer avoidable allocs because they wrap the raw binary data in a "block" type, +which is an interface, and thus heap-escapes; and we need none of that in the storage APIs, and just return the raw data. +They are also unable to support streaming operation, should you desire it. + +It's best to choose the shortest path and use the adapter to whatever layer you need to get to -- +for example, if you really want to use a `go-datastore` implementation, +*don't* use `bsadapter` and have it wrap a `go-blockstore` that wraps a `go-datastore` if you can help it: +instead, use `dsadapter` and wrap the `go-datastore` without any extra layers of indirection. +You should prefer this because most of the notes above about avoidable allocs are true when +the legacy interfaces are communicating with each other, as well... +so the less you use the internal layering of the legacy interfaces, the better off you'll be. + +Using a direct implementation of the storage APIs will suffer none of these overheads, +and so will always be your best bet if possible. + +If you have to use one of these adapters, hopefully the performance overheads fall within an acceptable margin. +If not: we'll be overjoyed to accept help porting things. diff --git a/storage/bsadapter/bsadapter.go b/storage/bsadapter/bsadapter.go new file mode 100644 index 00000000..4b5f0073 --- /dev/null +++ b/storage/bsadapter/bsadapter.go @@ -0,0 +1,120 @@ +package bsadapter + +import ( + "context" + "fmt" + + "github.com/ipfs/go-block-format" + "github.com/ipfs/go-cid" + "github.com/ipfs/go-ipfs-blockstore" +) + +// Adapter implements go-ipld-prime/storage.ReadableStorage +// and go-ipld-prime/storage.WritableStorage +// backed by a go-ipfs-blockstore.Blockstore. +// +// The go-ipfs-blockstore.Blockstore may internally have other configuration. +// We don't interfere with that here; +// such configuration should be handled when creating the go-ipfs-blockstore value. +// +// Note that this system will only work for certain structures of keys -- +// this is because the blockstore API works on the level of CIDs. +// As long as your key string is the binary form of a CID, it will work correctly. +// Other keys are not possible to support with this adapter. +// +// Contexts given to this system are checked for errors at the beginning of an operation, +// but otherwise have no effect, because the Blockstore API doesn't accept context parameters. +type Adapter struct { + Wrapped blockstore.Blockstore +} + +// Has implements go-ipld-prime/storage.Storage.Has. +func (a *Adapter) Has(ctx context.Context, key string) (bool, error) { + // Return early if the context is already closed. + // This is also the last time we'll check the context, + // since the Has method on Blockstore doesn't take them. + if ctx.Err() != nil { + return false, ctx.Err() + } + + // Do the inverse of cid.KeyString(), + // which is how a valid key for this adapter must've been produced. + k, err := cidFromBinString(key) + if err != nil { + return false, err + } + + // Delegate the Has call. + return a.Wrapped.Has(k) +} + +// Get implements go-ipld-prime/storage.ReadableStorage.Get. +func (a *Adapter) Get(ctx context.Context, key string) ([]byte, error) { + // Return early if the context is already closed. + // This is also the last time we'll check the context, + // since the Put method on Blockstore doesn't take them. + if ctx.Err() != nil { + return nil, ctx.Err() + } + + // Do the inverse of cid.KeyString(), + // which is how a valid key for this adapter must've been produced. + k, err := cidFromBinString(key) + if err != nil { + return nil, err + } + + // Delegate the Get call. + block, err := a.Wrapped.Get(k) + if err != nil { + return nil, err + } + + // Unwrap the actual raw data for return. + // Discard the rest. (It's a shame there was an alloc for that structure.) + return block.RawData(), nil +} + +// Put implements go-ipld-prime/storage.WritableStorage.Put. +func (a *Adapter) Put(ctx context.Context, key string, content []byte) error { + // Return early if the context is already closed. + // This is also the last time we'll check the context, + // since the Put method on Blockstore doesn't take them. + if ctx.Err() != nil { + return ctx.Err() + } + + // Do the inverse of cid.KeyString(), + // which is how a valid key for this adapter must've been produced. + k, err := cidFromBinString(key) + if err != nil { + return err + } + + // Create a structure that has the cid and the raw content together. + // This is necessary because it's the format demanded by Blockstore. + // (Unfortunately, it also provokes an allocation, because it uses interfaces; + // but we can't avoid that without changing the code in go-ipfs-blockstore.) + // The error is treated as a panic because it's only possible if a global debug var is set, + // and is for behavior that is not meant to be part of the contract of the storage APIs. + block, err := blocks.NewBlockWithCid(content, k) + if err != nil { + panic(err) + } + + // Delegate the Put call. + return a.Wrapped.Put(block) +} + +// Do the inverse of cid.KeyString(). +// (Unclear why go-cid doesn't offer a function for this itself.) +func cidFromBinString(key string) (cid.Cid, error) { + l, k, err := cid.CidFromBytes([]byte(key)) + if err != nil { + return cid.Undef, fmt.Errorf("bsrvadapter: key was not a cid: %w", err) + } + if l != len(key) { + return cid.Undef, fmt.Errorf("bsrvadapter: key was not a cid: had %d bytes leftover", len(key)-l) + } + return k, nil +} diff --git a/storage/bsadapter/go.mod b/storage/bsadapter/go.mod new file mode 100644 index 00000000..7732a5fb --- /dev/null +++ b/storage/bsadapter/go.mod @@ -0,0 +1,20 @@ +module github.com/ipld/go-ipld-prime/storage/bsadapter + +go 1.16 + +require ( + github.com/google/uuid v1.2.0 // indirect + github.com/ipfs/go-block-format v0.0.3 + github.com/ipfs/go-cid v0.1.0 + github.com/ipfs/go-datastore v0.4.5 // indirect + github.com/ipfs/go-ipfs-blockstore v0.1.6 + github.com/ipfs/go-log v1.0.5 // indirect + github.com/klauspost/cpuid/v2 v2.0.6 // indirect + github.com/pkg/errors v0.9.1 // indirect + go.uber.org/multierr v1.7.0 // indirect + golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a // indirect + golang.org/x/lint v0.0.0-20200302205851-738671d3881b // indirect + golang.org/x/sys v0.0.0-20210514084401-e8d321eab015 // indirect + gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c // indirect + gopkg.in/yaml.v2 v2.3.0 // indirect +) diff --git a/storage/bsadapter/go.sum b/storage/bsadapter/go.sum new file mode 100644 index 00000000..2d619987 --- /dev/null +++ b/storage/bsadapter/go.sum @@ -0,0 +1,191 @@ +github.com/BurntSushi/toml v0.3.1 h1:WXkYYl6Yr3qBf1K79EBnL4mak0OimBfB0XUf9Vl28OQ= +github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/go-check/check v0.0.0-20180628173108-788fd7840127/go.mod h1:9ES+weclKsC9YodN5RgxqK/VD9HM9JsCSh7rNhMZE98= +github.com/gogo/protobuf v1.2.1/go.mod h1:hp+jE20tsWTFYpLwKvXlhS1hjn+gTNwPg2I6zVXpSg4= +github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q= +github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q= +github.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI= +github.com/google/uuid v1.1.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.2.0 h1:qJYtXnJRWmpe7m/3XlyhrsLrEURqHRM2kxzoxXqyUDs= +github.com/google/uuid v1.2.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/gxed/hashland/keccakpg v0.0.1/go.mod h1:kRzw3HkwxFU1mpmPP8v1WyQzwdGfmKFJ6tItnhQ67kU= +github.com/gxed/hashland/murmur3 v0.0.1/go.mod h1:KjXop02n4/ckmZSnY2+HKcLud/tcmvhST0bie/0lS48= +github.com/hashicorp/golang-lru v0.5.4 h1:YDjusn29QI/Das2iO9M0BHnIbxPeyuCHsjMW+lJfyTc= +github.com/hashicorp/golang-lru v0.5.4/go.mod h1:iADmTwqILo4mZ8BN3D2Q6+9jd8WM5uGBxy+E8yxSoD4= +github.com/ipfs/bbloom v0.0.4 h1:Gi+8EGJ2y5qiD5FbsbpX/TMNcJw8gSqr7eyjHa4Fhvs= +github.com/ipfs/bbloom v0.0.4/go.mod h1:cS9YprKXpoZ9lT0n/Mw/a6/aFV6DTjTLYHeA+gyqMG0= +github.com/ipfs/go-block-format v0.0.2/go.mod h1:AWR46JfpcObNfg3ok2JHDUfdiHRgWhJgCQF+KIgOPJY= +github.com/ipfs/go-block-format v0.0.3 h1:r8t66QstRp/pd/or4dpnbVfXT5Gt7lOqRvC+/dDTpMc= +github.com/ipfs/go-block-format v0.0.3/go.mod h1:4LmD4ZUw0mhO+JSKdpWwrzATiEfM7WWgQ8H5l6P8MVk= +github.com/ipfs/go-cid v0.0.1/go.mod h1:GHWU/WuQdMPmIosc4Yn1bcCT7dSeX4lBafM7iqUPQvM= +github.com/ipfs/go-cid v0.0.4/go.mod h1:4LLaPOQwmk5z9LBgQnpkivrx8BJjUyGwTXCd5Xfj6+M= +github.com/ipfs/go-cid v0.0.7/go.mod h1:6Ux9z5e+HpkQdckYoX1PG/6xqKspzlEIR5SDmgqgC/I= +github.com/ipfs/go-cid v0.1.0 h1:YN33LQulcRHjfom/i25yoOZR4Telp1Hr/2RU3d0PnC0= +github.com/ipfs/go-cid v0.1.0/go.mod h1:rH5/Xv83Rfy8Rw6xG+id3DYAMUVmem1MowoKwdXmN2o= +github.com/ipfs/go-datastore v0.1.1/go.mod h1:w38XXW9kVFNp57Zj5knbKWM2T+KOZCGDRVNdgPHtbHw= +github.com/ipfs/go-datastore v0.4.5 h1:cwOUcGMLdLPWgu3SlrCckCMznaGADbPqE0r8h768/Dg= +github.com/ipfs/go-datastore v0.4.5/go.mod h1:eXTcaaiN6uOlVCLS9GjJUJtlvJfM3xk23w3fyfrmmJs= +github.com/ipfs/go-ipfs-blockstore v0.1.6 h1:+RNM/gkTF6lzLPtt/xqjEUXJuG0lFwAiv+MV8MoAhvA= +github.com/ipfs/go-ipfs-blockstore v0.1.6/go.mod h1:Jxm3XMVjh6R17WvxFEiyKBLUGr86HgIYJW/D/MwqeYQ= +github.com/ipfs/go-ipfs-delay v0.0.0-20181109222059-70721b86a9a8/go.mod h1:8SP1YXK1M1kXuc4KJZINY3TQQ03J2rwBG9QfXmbRPrw= +github.com/ipfs/go-ipfs-ds-help v0.1.1 h1:IW/bXGeaAZV2VH0Kuok+Ohva/zHkHmeLFBxC1k7mNPc= +github.com/ipfs/go-ipfs-ds-help v0.1.1/go.mod h1:SbBafGJuGsPI/QL3j9Fc5YPLeAu+SzOkI0gFwAg+mOs= +github.com/ipfs/go-ipfs-util v0.0.1/go.mod h1:spsl5z8KUnrve+73pOhSVZND1SIxPW5RyBCNzQxlJBc= +github.com/ipfs/go-ipfs-util v0.0.2 h1:59Sswnk1MFaiq+VcaknX7aYEyGyGDAA73ilhEK2POp8= +github.com/ipfs/go-ipfs-util v0.0.2/go.mod h1:CbPtkWJzjLdEcezDns2XYaehFVNXG9zrdrtMecczcsQ= +github.com/ipfs/go-log v0.0.1/go.mod h1:kL1d2/hzSpI0thNYjiKfjanbVNU+IIGA/WnNESY9leM= +github.com/ipfs/go-log v1.0.5 h1:2dOuUCB1Z7uoczMWgAyDck5JLb72zHzrMnGnCNNbvY8= +github.com/ipfs/go-log v1.0.5/go.mod h1:j0b8ZoR+7+R99LD9jZ6+AJsrzkPbSXbZfGakb5JPtIo= +github.com/ipfs/go-log/v2 v2.1.3 h1:1iS3IU7aXRlbgUpN8yTTpJ53NXYjAe37vcI5+5nYrzk= +github.com/ipfs/go-log/v2 v2.1.3/go.mod h1:/8d0SH3Su5Ooc31QlL1WysJhvyOTDCjcCZ9Axpmri6g= +github.com/ipfs/go-metrics-interface v0.0.1 h1:j+cpbjYvu4R8zbleSs36gvB7jR+wsL2fGD6n0jO4kdg= +github.com/ipfs/go-metrics-interface v0.0.1/go.mod h1:6s6euYU4zowdslK0GKHmqaIZ3j/b/tL7HTWtJ4VPgWY= +github.com/jbenet/go-cienv v0.1.0/go.mod h1:TqNnHUmJgXau0nCzC7kXWeotg3J9W34CUv5Djy1+FlA= +github.com/jbenet/goprocess v0.0.0-20160826012719-b497e2f366b8/go.mod h1:Ly/wlsjFq/qrU3Rar62tu1gASgGw6chQbSh/XgIIXCY= +github.com/jbenet/goprocess v0.1.4 h1:DRGOFReOMqqDNXwW70QkacFW0YN9QnwLV0Vqk+3oU0o= +github.com/jbenet/goprocess v0.1.4/go.mod h1:5yspPrukOVuOLORacaBi858NqyClJPQxYZlqdZVfqY4= +github.com/kisielk/errcheck v1.1.0/go.mod h1:EZBBE59ingxPouuu3KfxchcWSUPOHkagtvWXihfKN4Q= +github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8= +github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck= +github.com/klauspost/cpuid/v2 v2.0.4/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/klauspost/cpuid/v2 v2.0.6 h1:dQ5ueTiftKxp0gyjKSx5+8BtPWkyQbd95m8Gys/RarI= +github.com/klauspost/cpuid/v2 v2.0.6/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo= +github.com/kr/pretty v0.2.0/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI= +github.com/kr/pretty v0.2.1 h1:Fmg33tUaq4/8ym9TJN1x7sLJnHVwhP33CNkpYV/7rwI= +github.com/kr/pretty v0.2.1/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI= +github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= +github.com/kr/text v0.1.0 h1:45sCR5RtlFHMR4UwH9sdQ5TC8v0qDQCHnXt+kaKSTVE= +github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= +github.com/mattn/go-colorable v0.1.1/go.mod h1:FuOcm+DKB9mbwrcAfNl7/TZVBZ6rcnceauSikq3lYCQ= +github.com/mattn/go-isatty v0.0.5/go.mod h1:Iq45c/XA43vh69/j3iqttzPXn0bhXyGjM0Hdxcsrc5s= +github.com/minio/blake2b-simd v0.0.0-20160723061019-3f5f724cb5b1 h1:lYpkrQH5ajf0OXOcUbGjvZxxijuBwbbmlSxLiuofa+g= +github.com/minio/blake2b-simd v0.0.0-20160723061019-3f5f724cb5b1/go.mod h1:pD8RvIylQ358TN4wwqatJ8rNavkEINozVn9DtGI3dfQ= +github.com/minio/sha256-simd v0.0.0-20190131020904-2d45a736cd16/go.mod h1:2FMWW+8GMoPweT6+pI63m9YE3Lmw4J71hV56Chs1E/U= +github.com/minio/sha256-simd v0.1.1-0.20190913151208-6de447530771/go.mod h1:B5e1o+1/KgNmWrSQK08Y6Z1Vb5pwIktudl0J58iy0KM= +github.com/minio/sha256-simd v1.0.0 h1:v1ta+49hkWZyvaKwrQB8elexRqm6Y0aMLjCNsrYxo6g= +github.com/minio/sha256-simd v1.0.0/go.mod h1:OuYzVNI5vcoYIAmbIvHPl3N3jUzVedXbKy5RFepssQM= +github.com/mr-tron/base58 v1.1.0/go.mod h1:xcD2VGqlgYjBdcBLw+TuYLr8afG+Hj8g2eTVqeSzSU8= +github.com/mr-tron/base58 v1.1.2/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/mr-tron/base58 v1.1.3/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/mr-tron/base58 v1.2.0 h1:T/HDJBh4ZCPbU39/+c3rRvE0uKBQlU27+QI8LJ4t64o= +github.com/mr-tron/base58 v1.2.0/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/multiformats/go-base32 v0.0.3 h1:tw5+NhuwaOjJCC5Pp82QuXbrmLzWg7uxlMFp8Nq/kkI= +github.com/multiformats/go-base32 v0.0.3/go.mod h1:pLiuGC8y0QR3Ue4Zug5UzK9LjgbkL8NSQj0zQ5Nz/AA= +github.com/multiformats/go-base36 v0.1.0 h1:JR6TyF7JjGd3m6FbLU2cOxhC0Li8z8dLNGQ89tUg4F4= +github.com/multiformats/go-base36 v0.1.0/go.mod h1:kFGE83c6s80PklsHO9sRn2NCoffoRdUUOENyW/Vv6sM= +github.com/multiformats/go-multibase v0.0.1/go.mod h1:bja2MqRZ3ggyXtZSEDKpl0uO/gviWFaSteVbWT51qgs= +github.com/multiformats/go-multibase v0.0.3 h1:l/B6bJDQjvQ5G52jw4QGSYeOTZoAwIO77RblWplfIqk= +github.com/multiformats/go-multibase v0.0.3/go.mod h1:5+1R4eQrT3PkYZ24C3W2Ue2tPwIdYQD509ZjSb5y9Oc= +github.com/multiformats/go-multihash v0.0.1/go.mod h1:w/5tugSrLEbWqlcgJabL3oHFKTwfvkofsjW2Qa1ct4U= +github.com/multiformats/go-multihash v0.0.10/go.mod h1:YSLudS+Pi8NHE7o6tb3D8vrpKa63epEDmG8nTduyAew= +github.com/multiformats/go-multihash v0.0.13/go.mod h1:VdAWLKTwram9oKAatUcLxBNUjdtcVwxObEQBtRfuyjc= +github.com/multiformats/go-multihash v0.0.14/go.mod h1:VdAWLKTwram9oKAatUcLxBNUjdtcVwxObEQBtRfuyjc= +github.com/multiformats/go-multihash v0.0.15 h1:hWOPdrNqDjwHDx82vsYGSDZNyktOJJ2dzZJzFkOV1jM= +github.com/multiformats/go-multihash v0.0.15/go.mod h1:D6aZrWNLFTV/ynMpKsNtB40mJzmCl4jb1alC0OvHiHg= +github.com/multiformats/go-varint v0.0.5/go.mod h1:3Ls8CIEsrijN6+B7PbrXRPxHRPuXSrVKRY101jdMZYE= +github.com/multiformats/go-varint v0.0.6 h1:gk85QWKxh3TazbLxED/NlDVv8+q+ReFJk7Y2W/KhfNY= +github.com/multiformats/go-varint v0.0.6/go.mod h1:3Ls8CIEsrijN6+B7PbrXRPxHRPuXSrVKRY101jdMZYE= +github.com/opentracing/opentracing-go v1.0.2/go.mod h1:UkNAQd3GIcIGf0SeVgPpRdFStlNbqXla1AfSYxPUl2o= +github.com/opentracing/opentracing-go v1.2.0 h1:uEJPy/1a5RIPAJ0Ov+OIO8OxWu77jEv+1B0VhjKrZUs= +github.com/opentracing/opentracing-go v1.2.0/go.mod h1:GxEUsuufX4nBwe+T+Wl9TAgYrxe9dPLANfrWvHYVTgc= +github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= +github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4= +github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4= +github.com/spaolacci/murmur3 v1.1.0/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2Kzu9HwQUA= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= +github.com/stretchr/testify v1.7.0 h1:nwc3DEeHmmLAfoZucVR881uASk0Mfjw8xYJ99tb5CcY= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/whyrusleeping/go-logging v0.0.0-20170515211332-0457bb6b88fc/go.mod h1:bopw91TMyo8J3tvftk8xmU2kPmlrt4nScJQZU2hE5EM= +github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= +github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= +go.uber.org/atomic v1.6.0/go.mod h1:sABNBOSYdrvTF6hTgEIbc7YasKWGhgEQZyfxyTvoXHQ= +go.uber.org/atomic v1.7.0 h1:ADUqmZGgLDDfbSL9ZmPxKTybcoEYHgpYfELNoN+7hsw= +go.uber.org/atomic v1.7.0/go.mod h1:fEN4uk6kAWBTFdckzkM89CLk9XfWZrxpCo0nPH17wJc= +go.uber.org/multierr v1.5.0/go.mod h1:FeouvMocqHpRaaGuG9EjoKcStLC43Zu/fmqdUMPcKYU= +go.uber.org/multierr v1.6.0/go.mod h1:cdWPpRnG4AhwMwsgIHip0KRBQjJy5kYEpYjJxpXp9iU= +go.uber.org/multierr v1.7.0 h1:zaiO/rmgFjbmCXdSYJWQcdvOCsthmdaHfr3Gm2Kx4Ec= +go.uber.org/multierr v1.7.0/go.mod h1:7EAYxJLBy9rStEaz58O2t4Uvip6FSURkq8/ppBp95ak= +go.uber.org/tools v0.0.0-20190618225709-2cfd321de3ee/go.mod h1:vJERXedbb3MVM5f9Ejo0C68/HhF8uaILCdgjnY+goOA= +go.uber.org/zap v1.16.0 h1:uFRZXykJGK9lLY4HtgSw44DnIcAM+kRBP7x5m+NpAOM= +go.uber.org/zap v1.16.0/go.mod h1:MA8QOfq0BHJwdXa996Y4dYkAqRKB8/1K1QMMZVaNZjQ= +golang.org/x/crypto v0.0.0-20190211182817-74369b46fc67/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20190510104115-cbcb75029529/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20190611184440-5c40567a22f8/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20210220033148-5ea612d1eb83/go.mod h1:jdWPYTVW3xRLrWPugEBEK3UY2ZEsg3UU495nc5E+M+I= +golang.org/x/crypto v0.0.0-20210506145944-38f3c27a63bf/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8= +golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a h1:kr2P4QFmQr29mSLA43kwrOcgcReGTfbE9N577tCTuBc= +golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8= +golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= +golang.org/x/lint v0.0.0-20200302205851-738671d3881b h1:Wh+f8QHJXR411sJR8/vRBTZ7YapZaRvUcLFFJhusH0k= +golang.org/x/lint v0.0.0-20200302205851-738671d3881b/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY= +golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc= +golang.org/x/mod v0.1.1-0.20191105210325-c90efee705ee/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg= +golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= +golang.org/x/mod v0.3.0 h1:RM4zey1++hCTbCVQfnWeKs9/IEsaBLA8vTkd0WVtmH4= +golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= +golang.org/x/net v0.0.0-20190227160552-c95aed5357e7/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= +golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg= +golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190219092855-153ac476189d/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190222072716-a9d3bda3a223/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210309074719-68d13333faf2/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210514084401-e8d321eab015 h1:hZR0X1kPW+nwyJ9xRxqZk1vx5RUObAPBdKVvXPDUH/E= +golang.org/x/sys v0.0.0-20210514084401-e8d321eab015/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/term v0.0.0-20201117132131-f5c789dd3221/go.mod h1:Nr5EML6q2oocZ2LXRh80K7BxOlk5/8JxuGnuhpl+muw= +golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= +golang.org/x/tools v0.0.0-20180221164845-07fd8470d635/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= +golang.org/x/tools v0.0.0-20190621195816-6e04913cbbac/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= +golang.org/x/tools v0.0.0-20191029041327-9cc4af7d6b2c/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20191029190741-b9c20aec41a5/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20200130002326-2f3ba24bd6e7/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= +golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= +golang.org/x/tools v0.0.0-20210106214847-113979e3529a h1:CB3a9Nez8M13wwlr/E2YtwoU+qYHKfC+JrDa45RXXoQ= +golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= +golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE= +golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= +gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= +gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI= +gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v2 v2.3.0 h1:clyUAQHOM3G0M3f5vQj7LuJrETvjVot3Z5el9nffUtU= +gopkg.in/yaml.v2 v2.3.0/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b h1:h8qDotaEPuJATrMmW04NCwg7v22aHH28wwpauUhK9Oo= +gopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +honnef.co/go/tools v0.0.1-2019.2.3 h1:3JgtbtFHMiCmsznwGVTUWbgGov+pVqnlf1dEJTNAXeM= +honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg= diff --git a/storage/bsrvadapter/README.md b/storage/bsrvadapter/README.md new file mode 100644 index 00000000..d8d6a04c --- /dev/null +++ b/storage/bsrvadapter/README.md @@ -0,0 +1,58 @@ +bsrvadapter +=========== + +The `bsrvadapter` package/module is a small piece of glue code to connect +the `github.com/ipfs/go-blockservice` package, and packages implementing its interfaces, +forward into the `go-ipld-prime/storage` interfaces. + +This can be used to rig systems like Bitswap up behind go-ipld-prime storage APIs. + +(Whether or not this is a good idea is debatable. +It should be noted that both the `ipfs/go-blockservice` API, +as well as Bitswap in particular as an implementation, +are inherently prone to the infamous "N+1 Query Problem". +Treating a remote network fetch as equivalent to a local low-latency operation +just isn't a good idea for performance or predictability, no matter how you slice it. +Nonetheless: it's possible, using this code, if you really want to do it.) + + +Why structured like this? +------------------------- + +See similar discussion in the `../dsadapter` module. + + +Which of `dsadapter` vs `bsadapter` vs `bsrvadapter` should I use? +------------------------------------------------------------------ + +None of them, ideally. +A direct implementation of the storage APIs will almost certainly be able to perform better than any of these adapters. + +Failing that: use the adapter matching whatever you've got on hand in your code. + +There is no correct choice. + +dsadapter suffers avoidable excessive allocs in processing its key type, +due to choices in the interior of `github.com/ipfs/go-datastore`. +It is also unable to support streaming operation, should you desire it. + +bsadapter and bsrvadapter both also suffer overhead due to their key type, +because they require a transformation back from the plain binary strings used in the storage API to the concrete go-cid type, +which spends some avoidable CPU time (and also, at present, causes avoidable allocs because of some interesting absenses in `go-cid`). +Additionally, they suffer avoidable allocs because they wrap the raw binary data in a "block" type, +which is an interface, and thus heap-escapes; and we need none of that in the storage APIs, and just return the raw data. +They are also unable to support streaming operation, should you desire it. + +It's best to choose the shortest path and use the adapter to whatever layer you need to get to -- +for example, if you really want to use a `go-datastore` implementation, +*don't* use `bsadapter` and have it wrap a `go-blockstore` that wraps a `go-datastore` if you can help it: +instead, use `dsadapter` and wrap the `go-datastore` without any extra layers of indirection. +You should prefer this because most of the notes above about avoidable allocs are true when +the legacy interfaces are communicating with each other, as well... +so the less you use the internal layering of the legacy interfaces, the better off you'll be. + +Using a direct implementation of the storage APIs will suffer none of these overheads, +and so will always be your best bet if possible. + +If you have to use one of these adapters, hopefully the performance overheads fall within an acceptable margin. +If not: we'll be overjoyed to accept help porting things. diff --git a/storage/bsrvadapter/bsrvadapter.go b/storage/bsrvadapter/bsrvadapter.go new file mode 100644 index 00000000..f3651a19 --- /dev/null +++ b/storage/bsrvadapter/bsrvadapter.go @@ -0,0 +1,129 @@ +package bsrvadapter + +import ( + "context" + "fmt" + + "github.com/ipfs/go-block-format" + "github.com/ipfs/go-blockservice" + "github.com/ipfs/go-cid" +) + +// Adapter implements go-ipld-prime/storage.ReadableStorage +// and go-ipld-prime/storage.WritableStorage +// backed by a go-blockservice.BlockService. +// +// The go-blockservice.BlockService may internally have other configuration, +// and contain whole other systems like Bitswap for transport. +// We don't interfere with that here; +// such configuration should be handled when creating the go-blockservice value. +// +// Note that this system will only work for certain structures of keys -- +// this is because the blockservice API works on the level of CIDs. +// As long as your key string is the binary form of a CID, it will work correctly. +// Other keys are not possible to support with this adapter. +// +// Contexts given to this system are passed through where possible, but it is not possible in all cases. +// For operations where the underlying interface doesn't accept a context parameter, +// this adapter will check the context for errors before beginning an operation, +// but the context will otherwise have no effect. +// For operations where BlockService does accept a context, we pass it on. +type Adapter struct { + Wrapped blockservice.BlockService +} + +// Has implements go-ipld-prime/storage.Storage.Has. +// +// Note that for a BlockService, the Has operation has rather unusual semantics. +// Has may return false, and an immediately subsequent Get for the same key might return data! +// This is because the Has operation is defined as whether +// the Blockstore that the BlockService wraps has the requested key, immediately, locally; +// while the Get operation might use the BlockService to go _find_ the requested key +// and its content, even remotely! +func (a *Adapter) Has(ctx context.Context, key string) (bool, error) { + // Return early if the context is already closed. + // This is also the last time we'll check the context, + // since the Has method is on Blockstore, which doesn't take them. + if ctx.Err() != nil { + return false, ctx.Err() + } + + // Do the inverse of cid.KeyString(), + // which is how a valid key for this adapter must've been produced. + k, err := cidFromBinString(key) + if err != nil { + return false, err + } + + // Delegate the Has call. + return a.Wrapped.Blockstore().Has(k) +} + +// Get implements go-ipld-prime/storage.ReadableStorage.Get. +func (a *Adapter) Get(ctx context.Context, key string) ([]byte, error) { + // No need to check the context proactively here -- + // the BlockService API actually accepts context. + + // Do the inverse of cid.KeyString(), + // which is how a valid key for this adapter must've been produced. + k, err := cidFromBinString(key) + if err != nil { + return nil, err + } + + // Delegate the Get call. + // It's called "GetBlock" in BlockService. + block, err := a.Wrapped.GetBlock(ctx, k) + if err != nil { + return nil, err + } + + // Unwrap the actual raw data for return. + // Discard the rest. (It's a shame there was an alloc for that structure.) + return block.RawData(), nil +} + +// Put implements go-ipld-prime/storage.WritableStorage.Put. +func (a *Adapter) Put(ctx context.Context, key string, content []byte) error { + // Return early if the context is already closed. + // This is also the last time we'll check the context, + // since the AddBlock method on BlockService that we'll eventually be delegating to doesn't take them. + if ctx.Err() != nil { + return ctx.Err() + } + + // Do the inverse of cid.KeyString(), + // which is how a valid key for this adapter must've been produced. + k, err := cidFromBinString(key) + if err != nil { + return err + } + + // Create a structure that has the cid and the raw content together. + // This is necessary because it's the format demanded by BlockService. + // (Unfortunately, it also provokes an allocation, because it uses interfaces; + // but we can't avoid that without changing the code in go-blockservice.) + // The error is treated as a panic because it's only possible if a global debug var is set, + // and is for behavior that is not meant to be part of the contract of the storage APIs. + block, err := blocks.NewBlockWithCid(content, k) + if err != nil { + panic(err) + } + + // Delegate the Put call. + // It's called "AddBlock" in BlockService. + return a.Wrapped.AddBlock(block) +} + +// Do the inverse of cid.KeyString(). +// (Unclear why go-cid doesn't offer a function for this itself.) +func cidFromBinString(key string) (cid.Cid, error) { + l, k, err := cid.CidFromBytes([]byte(key)) + if err != nil { + return cid.Undef, fmt.Errorf("bsrvadapter: key was not a cid: %w", err) + } + if l != len(key) { + return cid.Undef, fmt.Errorf("bsrvadapter: key was not a cid: had %d bytes leftover", len(key)-l) + } + return k, nil +} diff --git a/storage/bsrvadapter/go.mod b/storage/bsrvadapter/go.mod new file mode 100644 index 00000000..535a1ca6 --- /dev/null +++ b/storage/bsrvadapter/go.mod @@ -0,0 +1,9 @@ +module github.com/ipld/go-ipld-prime/storage/bsrvadapter + +go 1.16 + +require ( + github.com/ipfs/go-block-format v0.0.3 + github.com/ipfs/go-blockservice v0.1.7 + github.com/ipfs/go-cid v0.1.0 +) diff --git a/storage/bsrvadapter/go.sum b/storage/bsrvadapter/go.sum new file mode 100644 index 00000000..0237a5e1 --- /dev/null +++ b/storage/bsrvadapter/go.sum @@ -0,0 +1,826 @@ +cloud.google.com/go v0.26.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= +cloud.google.com/go v0.31.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= +cloud.google.com/go v0.34.0/go.mod h1:aQUYkXzVsufM+DwF1aE+0xfcU+56JwCaLick0ClmMTw= +cloud.google.com/go v0.37.0/go.mod h1:TS1dMSSfndXH133OKGwekG838Om/cQT0BUHV3HcBgoo= +dmitri.shuralyov.com/app/changes v0.0.0-20180602232624-0a106ad413e3/go.mod h1:Yl+fi1br7+Rr3LqpNJf1/uxUdtRUV+Tnj0o93V2B9MU= +dmitri.shuralyov.com/html/belt v0.0.0-20180602232347-f7d459c86be0/go.mod h1:JLBrvjyP0v+ecvNYvCpyZgu5/xkfAUhi6wJj28eUfSU= +dmitri.shuralyov.com/service/change v0.0.0-20181023043359-a85b471d5412/go.mod h1:a1inKt/atXimZ4Mv927x+r7UpyzRUf4emIoiiSC2TN4= +dmitri.shuralyov.com/state v0.0.0-20180228185332-28bcc343414c/go.mod h1:0PRwlb0D6DFvNNtx+9ybjezNCa8XF0xaYcETyp6rHWU= +git.apache.org/thrift.git v0.0.0-20180902110319-2566ecd5d999/go.mod h1:fPE2ZNJGynbRyZ4dJvy6G277gSllfV2HJqblrnkyeyg= +github.com/AndreasBriese/bbloom v0.0.0-20180913140656-343706a395b7/go.mod h1:bOvUY6CB00SOBii9/FifXqc0awNKxLFCL/+pkDPuyl8= +github.com/AndreasBriese/bbloom v0.0.0-20190306092124-e2d15f34fcf9/go.mod h1:bOvUY6CB00SOBii9/FifXqc0awNKxLFCL/+pkDPuyl8= +github.com/BurntSushi/toml v0.3.1 h1:WXkYYl6Yr3qBf1K79EBnL4mak0OimBfB0XUf9Vl28OQ= +github.com/BurntSushi/toml v0.3.1/go.mod h1:xHWCNGjB5oqiDr8zfno3MHue2Ht5sIBksp03qcyfWMU= +github.com/Kubuxu/go-os-helper v0.0.1/go.mod h1:N8B+I7vPCT80IcP58r50u4+gEEcsZETFUpAzWW2ep1Y= +github.com/OneOfOne/xxhash v1.2.2/go.mod h1:HSdplMjZKSmBqAxg5vPj2TmRDmfkzw+cTzAElWljhcU= +github.com/aead/siphash v1.0.1/go.mod h1:Nywa3cDsYNNK3gaciGTWPwHt0wlpNV15vwmswBAUSII= +github.com/anmitsu/go-shlex v0.0.0-20161002113705-648efa622239/go.mod h1:2FmKhYUyUczH0OGQWaF5ceTx0UBShxjsH6f8oGKYe2c= +github.com/armon/consul-api v0.0.0-20180202201655-eb2c6b5be1b6/go.mod h1:grANhF5doyWs3UAsr3K4I6qtAmlQcZDesFNEHPZAzj8= +github.com/beorn7/perks v0.0.0-20180321164747-3a771d992973/go.mod h1:Dwedo/Wpr24TaqPxmxbtue+5NUziq4I4S80YR8gNf3Q= +github.com/bradfitz/go-smtpd v0.0.0-20170404230938-deb6d6237625/go.mod h1:HYsPBTaaSFSlLx/70C2HPIMNZpVV8+vt/A+FMnYP11g= +github.com/btcsuite/btcd v0.0.0-20190213025234-306aecffea32/go.mod h1:DrZx5ec/dmnfpw9KyYoQyYo7d0KEvTkk/5M/vbZjAr8= +github.com/btcsuite/btcd v0.0.0-20190523000118-16327141da8c/go.mod h1:3J08xEfcugPacsc34/LKRU2yO7YmuT8yt28J8k2+rrI= +github.com/btcsuite/btcd v0.0.0-20190824003749-130ea5bddde3/go.mod h1:3J08xEfcugPacsc34/LKRU2yO7YmuT8yt28J8k2+rrI= +github.com/btcsuite/btcd v0.20.1-beta/go.mod h1:wVuoA8VJLEcwgqHBwHmzLRazpKxTv13Px/pDuV7OomQ= +github.com/btcsuite/btcd v0.21.0-beta/go.mod h1:ZSWyehm27aAuS9bvkATT+Xte3hjHZ+MRgMY/8NJ7K94= +github.com/btcsuite/btclog v0.0.0-20170628155309-84c8d2346e9f/go.mod h1:TdznJufoqS23FtqVCzL0ZqgP5MqXbb4fg/WgDys70nA= +github.com/btcsuite/btcutil v0.0.0-20190207003914-4c204d697803/go.mod h1:+5NJ2+qvTyV9exUAL/rxXi3DcLg2Ts+ymUAY5y4NvMg= +github.com/btcsuite/btcutil v0.0.0-20190425235716-9e5f4b9a998d/go.mod h1:+5NJ2+qvTyV9exUAL/rxXi3DcLg2Ts+ymUAY5y4NvMg= +github.com/btcsuite/btcutil v1.0.2/go.mod h1:j9HUFwoQRsZL3V4n+qG+CUnEGHOarIxfC3Le2Yhbcts= +github.com/btcsuite/go-socks v0.0.0-20170105172521-4720035b7bfd/go.mod h1:HHNXQzUsZCxOoE+CPiyCTO6x34Zs86zZUiwtpXoGdtg= +github.com/btcsuite/goleveldb v0.0.0-20160330041536-7834afc9e8cd/go.mod h1:F+uVaaLLH7j4eDXPRvw78tMflu7Ie2bzYOH4Y8rRKBY= +github.com/btcsuite/goleveldb v1.0.0/go.mod h1:QiK9vBlgftBg6rWQIj6wFzbPfRjiykIEhBH4obrXJ/I= +github.com/btcsuite/snappy-go v0.0.0-20151229074030-0bdef8d06723/go.mod h1:8woku9dyThutzjeg+3xrA5iCpBRH8XEEg3lh6TiUghc= +github.com/btcsuite/snappy-go v1.0.0/go.mod h1:8woku9dyThutzjeg+3xrA5iCpBRH8XEEg3lh6TiUghc= +github.com/btcsuite/websocket v0.0.0-20150119174127-31079b680792/go.mod h1:ghJtEyQwv5/p4Mg4C0fgbePVuGr935/5ddU9Z3TmDRY= +github.com/btcsuite/winsvc v1.0.0/go.mod h1:jsenWakMcC0zFBFurPLEAyrnc/teJEM1O46fmI40EZs= +github.com/buger/jsonparser v0.0.0-20181115193947-bf1c66bbce23/go.mod h1:bbYlZJ7hK1yFx9hf58LP0zeX7UjIGs20ufpu3evjr+s= +github.com/census-instrumentation/opencensus-proto v0.2.1/go.mod h1:f6KPmirojxKA12rnyqOA5BBL4O983OfeGPqjHWSTneU= +github.com/cespare/xxhash v1.1.0/go.mod h1:XrSqR1VqqWfGrhpAt58auRo0WTKS1nRRg3ghfAqPWnc= +github.com/cheekybits/genny v1.0.0/go.mod h1:+tQajlRqAUrPI7DOSpB0XAqZYtQakVtB7wXkRAgjxjQ= +github.com/client9/misspell v0.3.4/go.mod h1:qj6jICC3Q7zFZvVWo7KLAzC3yx5G7kyvSDkc90ppPyw= +github.com/cncf/udpa/go v0.0.0-20191209042840-269d4d468f6f/go.mod h1:M8M6+tZqaGXZJjfX53e64911xZQV5JYwmTeXPW+k8Sc= +github.com/coreos/etcd v3.3.10+incompatible/go.mod h1:uF7uidLiAD3TWHmW31ZFd/JWoc32PjwdhPthX9715RE= +github.com/coreos/go-etcd v2.0.0+incompatible/go.mod h1:Jez6KQU2B/sWsbdaef3ED8NzMklzPG4d5KIOhIy30Tk= +github.com/coreos/go-semver v0.2.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk= +github.com/coreos/go-semver v0.3.0/go.mod h1:nnelYz7RCh+5ahJtPPxZlU+153eP4D4r3EedlOD2RNk= +github.com/coreos/go-systemd v0.0.0-20181012123002-c6f51f82210d/go.mod h1:F5haX7vjVVG0kc13fIWeqUViNPyEJxv/OmvnBo0Yme4= +github.com/cpuguy83/go-md2man v1.0.10/go.mod h1:SmD6nW6nTyfqj6ABTjUi3V3JVMnlJmwcJI5acqYI6dE= +github.com/cskr/pubsub v1.0.2/go.mod h1:/8MzYXk/NJAz782G8RPkFzXTZVu63VotefPnR9TIRis= +github.com/davecgh/go-spew v0.0.0-20171005155431-ecdeabc65495/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c= +github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38= +github.com/davidlazar/go-crypto v0.0.0-20170701192655-dcfb0a7ac018/go.mod h1:rQYf4tfk5sSwFsnDg3qYaBxSjsD9S8+59vW0dKUgme4= +github.com/davidlazar/go-crypto v0.0.0-20200604182044-b73af7476f6c/go.mod h1:6UhI8N9EjYm1c2odKpFpAYeR8dsBeM7PtzQhRgxRr9U= +github.com/decred/dcrd/lru v1.0.0/go.mod h1:mxKOwFd7lFjN2GZYsiz/ecgqR6kkYAl+0pz0tEMk218= +github.com/dgraph-io/badger v1.5.5-0.20190226225317-8115aed38f8f/go.mod h1:VZxzAIRPHRVNRKRo6AXrX9BJegn6il06VMTZVJYCIjQ= +github.com/dgraph-io/badger v1.6.0-rc1/go.mod h1:zwt7syl517jmP8s94KqSxTlM6IMsdhYy6psNgSztDR4= +github.com/dgraph-io/badger v1.6.0/go.mod h1:zwt7syl517jmP8s94KqSxTlM6IMsdhYy6psNgSztDR4= +github.com/dgraph-io/badger v1.6.1/go.mod h1:FRmFw3uxvcpa8zG3Rxs0th+hCLIuaQg8HlNV5bjgnuU= +github.com/dgraph-io/ristretto v0.0.2/go.mod h1:KPxhHT9ZxKefz+PCeOGsrHpl1qZ7i70dGTu2u+Ahh6E= +github.com/dgryski/go-farm v0.0.0-20190104051053-3adb47b1fb0f/go.mod h1:SqUrOPUnsFjfmXRMNPybcSiG0BgUW2AuFH8PAnS2iTw= +github.com/dgryski/go-farm v0.0.0-20190423205320-6a90982ecee2/go.mod h1:SqUrOPUnsFjfmXRMNPybcSiG0BgUW2AuFH8PAnS2iTw= +github.com/dustin/go-humanize v1.0.0/go.mod h1:HtrtbFcZ19U5GC7JDqmcUSB87Iq5E25KnS6fMYU6eOk= +github.com/envoyproxy/go-control-plane v0.9.0/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= +github.com/envoyproxy/go-control-plane v0.9.1-0.20191026205805-5f8ba28d4473/go.mod h1:YTl/9mNaCwkRvm6d1a2C3ymFceY/DCBVvsKhRF0iEA4= +github.com/envoyproxy/go-control-plane v0.9.4/go.mod h1:6rpuAdCZL397s3pYoYcLgu1mIlRU8Am5FuJP05cCM98= +github.com/envoyproxy/protoc-gen-validate v0.1.0/go.mod h1:iSmxcyjqTsJpI2R4NaDN7+kN2VEUnK/pcBlmesArF7c= +github.com/flynn/go-shlex v0.0.0-20150515145356-3f9db97f8568/go.mod h1:xEzjJPgXI435gkrCt3MPfRiAkVrwSbHsst4LCFVfpJc= +github.com/flynn/noise v0.0.0-20180327030543-2492fe189ae6/go.mod h1:1i71OnUq3iUe1ma7Lr6yG6/rjvM3emb6yoL7xLFzcVQ= +github.com/flynn/noise v1.0.0/go.mod h1:xbMo+0i6+IGbYdJhF31t2eR1BIU0CYc12+BNAKwUTag= +github.com/francoispqt/gojay v1.2.13/go.mod h1:ehT5mTG4ua4581f1++1WLG0vPdaA9HaiDsoyrBGkyDY= +github.com/fsnotify/fsnotify v1.4.7/go.mod h1:jwhsz4b93w/PPRr/qN1Yymfu8t87LnFCMoQvtojpjFo= +github.com/fsnotify/fsnotify v1.4.9/go.mod h1:znqG4EE+3YCdAaPaxE2ZRY/06pZUdp0tY4IgpuI1SZQ= +github.com/ghodss/yaml v1.0.0/go.mod h1:4dBDuWmgqj2HViK6kFavaiC9ZROes6MMH2rRYeMEF04= +github.com/gliderlabs/ssh v0.1.1/go.mod h1:U7qILu1NlMHj9FlMhZLlkCdDnU1DBEAqr0aevW3Awn0= +github.com/go-check/check v0.0.0-20180628173108-788fd7840127/go.mod h1:9ES+weclKsC9YodN5RgxqK/VD9HM9JsCSh7rNhMZE98= +github.com/go-errors/errors v1.0.1/go.mod h1:f4zRHt4oKfwPJE5k8C9vpYG+aDHdBFUsgrm6/TyX73Q= +github.com/gogo/protobuf v1.1.1/go.mod h1:r8qH/GZQm5c6nD/R0oafs1akxWv10x8SbQlK7atdtwQ= +github.com/gogo/protobuf v1.2.1/go.mod h1:hp+jE20tsWTFYpLwKvXlhS1hjn+gTNwPg2I6zVXpSg4= +github.com/gogo/protobuf v1.3.0/go.mod h1:SlYgWuQ5SjCEi6WLHjHCa1yvBfUnHcTbrrZtXPKa29o= +github.com/gogo/protobuf v1.3.1/go.mod h1:SlYgWuQ5SjCEi6WLHjHCa1yvBfUnHcTbrrZtXPKa29o= +github.com/gogo/protobuf v1.3.2 h1:Ov1cvc58UF3b5XjBnZv7+opcTcQFZebYjWzi34vdm4Q= +github.com/gogo/protobuf v1.3.2/go.mod h1:P1XiOD3dCwIKUDQYPy72D8LYyHL2YPYrpS2s69NZV8Q= +github.com/golang/glog v0.0.0-20160126235308-23def4e6c14b/go.mod h1:SBH7ygxi8pfUlaOkMMuAQtPIUF8ecWP5IEl/CR7VP2Q= +github.com/golang/groupcache v0.0.0-20190702054246-869f871628b6/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= +github.com/golang/groupcache v0.0.0-20191027212112-611e8accdfc9/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= +github.com/golang/groupcache v0.0.0-20200121045136-8c9f03a8e57e/go.mod h1:cIg4eruTrX1D+g88fzRXU5OdNfaM+9IcxsU14FzY7Hc= +github.com/golang/lint v0.0.0-20180702182130-06c8688daad7/go.mod h1:tluoj9z5200jBnyusfRPU2LqT6J+DAorxEvtC7LHB+E= +github.com/golang/mock v1.1.1/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= +github.com/golang/mock v1.2.0/go.mod h1:oTYuIxOrZwtPieC+H1uAHpcLFnEyAGVDL/k47Jfbm0A= +github.com/golang/mock v1.4.0/go.mod h1:UOMv5ysSaYNkG+OFQykRIcU/QvvxJf3p21QfJ2Bt3cw= +github.com/golang/mock v1.4.4/go.mod h1:l3mdAwkq5BuhzHwde/uurv3sEJeZMXNpwsxVWU71h+4= +github.com/golang/protobuf v1.2.0/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= +github.com/golang/protobuf v1.3.0/go.mod h1:Qd/q+1AKNOZr9uGQzbzCmRO6sUih6GTPZv6a1/R87v0= +github.com/golang/protobuf v1.3.1/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= +github.com/golang/protobuf v1.3.2/go.mod h1:6lQm79b+lXiMfvg/cZm0SGofjICqVBUtrP5yJMmIC1U= +github.com/golang/protobuf v1.3.3/go.mod h1:vzj43D7+SQXF/4pzW/hwtAqwc6iTitCiVSaWz5lYuqw= +github.com/golang/protobuf v1.4.0-rc.1/go.mod h1:ceaxUfeHdC40wWswd/P6IGgMaK3YpKi5j83Wpe3EHw8= +github.com/golang/protobuf v1.4.0-rc.1.0.20200221234624-67d41d38c208/go.mod h1:xKAWHe0F5eneWXFV3EuXVDTCmh+JuBKY0li0aMyXATA= +github.com/golang/protobuf v1.4.0-rc.2/go.mod h1:LlEzMj4AhA7rCAGe4KMBDvJI+AwstrUpVNzEA03Pprs= +github.com/golang/protobuf v1.4.0-rc.4.0.20200313231945-b860323f09d0/go.mod h1:WU3c8KckQ9AFe+yFwt9sWVRKCVIyN9cPHBJSNnbL67w= +github.com/golang/protobuf v1.4.0/go.mod h1:jodUvKwWbYaEsadDk5Fwe5c77LiNKVO9IDvqG2KuDX0= +github.com/golang/protobuf v1.4.1/go.mod h1:U8fpvMrcmy5pZrNK1lt4xCsGvpyWQ/VVv6QDs8UjoX8= +github.com/golang/protobuf v1.4.2/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= +github.com/golang/protobuf v1.4.3/go.mod h1:oDoupMAO8OvCJWAcko0GGGIgR6R6ocIYbsSw735rRwI= +github.com/golang/snappy v0.0.0-20180518054509-2e65f85255db/go.mod h1:/XxbfmMg8lxefKM7IXC3fBNl/7bRcc72aCRzEWrmP2Q= +github.com/google/btree v0.0.0-20180813153112-4030bb1f1f0c/go.mod h1:lNA+9X1NB3Zf8V7Ke586lFgjr2dZNuvo3lPJSGZ5JPQ= +github.com/google/go-cmp v0.2.0/go.mod h1:oXzfMopK8JAjlY9xF4vHSVASa0yLyX7SntLO5aqRK0M= +github.com/google/go-cmp v0.3.0/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= +github.com/google/go-cmp v0.3.1/go.mod h1:8QqcDgzrUqlUb/G2PQTWiueGozuR1884gddMywk6iLU= +github.com/google/go-cmp v0.4.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.5.0/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-cmp v0.5.3/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE= +github.com/google/go-github v17.0.0+incompatible/go.mod h1:zLgOLi98H3fifZn+44m+umXrS52loVEgC2AApnigrVQ= +github.com/google/go-querystring v1.0.0/go.mod h1:odCYkC5MyYFN7vkCjXpyrEuKhc/BUO6wN/zVPAxq5ck= +github.com/google/gopacket v1.1.17/go.mod h1:UdDNZ1OO62aGYVnPhxT1U6aI7ukYtA/kB8vaU0diBUM= +github.com/google/gopacket v1.1.19/go.mod h1:iJ8V8n6KS+z2U1A8pUwu8bW5SyEMkXJB8Yo/Vo+TKTo= +github.com/google/martian v2.1.0+incompatible/go.mod h1:9I4somxYTbIHy5NJKHRl3wXiIaQGbYVAs8BPL6v8lEs= +github.com/google/pprof v0.0.0-20181206194817-3ea8567a2e57/go.mod h1:zfwlbNMJ+OItoe0UupaVj+oy1omPYYDuagoSzA8v9mc= +github.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI= +github.com/google/uuid v1.1.1/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.1.2/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/google/uuid v1.2.0 h1:qJYtXnJRWmpe7m/3XlyhrsLrEURqHRM2kxzoxXqyUDs= +github.com/google/uuid v1.2.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo= +github.com/googleapis/gax-go v2.0.0+incompatible/go.mod h1:SFVmujtThgffbyetf+mdk2eWhX2bMyUtNHzFKcPA9HY= +github.com/googleapis/gax-go/v2 v2.0.3/go.mod h1:LLvjysVCY1JZeum8Z6l8qUty8fiNwE08qbEPm1M08qg= +github.com/gopherjs/gopherjs v0.0.0-20181017120253-0766667cb4d1/go.mod h1:wJfORRmW1u3UXTncJ5qlYoELFm8eSnnEO6hX4iZ3EWY= +github.com/gorilla/websocket v1.4.1/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/gorilla/websocket v1.4.2/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE= +github.com/gregjones/httpcache v0.0.0-20180305231024-9cad4c3443a7/go.mod h1:FecbI9+v66THATjSRHfNgh1IVFe/9kFxbXtjV0ctIMA= +github.com/grpc-ecosystem/grpc-gateway v1.5.0/go.mod h1:RSKVYQBd5MCa4OVpNdGskqpgL2+G+NZTnrVHpWWfpdw= +github.com/gxed/hashland/keccakpg v0.0.1/go.mod h1:kRzw3HkwxFU1mpmPP8v1WyQzwdGfmKFJ6tItnhQ67kU= +github.com/gxed/hashland/murmur3 v0.0.1/go.mod h1:KjXop02n4/ckmZSnY2+HKcLud/tcmvhST0bie/0lS48= +github.com/hashicorp/golang-lru v0.5.0/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= +github.com/hashicorp/golang-lru v0.5.1/go.mod h1:/m3WP610KZHVQ1SGc6re/UDhFvYD7pJ4Ao+sR/qLZy8= +github.com/hashicorp/golang-lru v0.5.4 h1:YDjusn29QI/Das2iO9M0BHnIbxPeyuCHsjMW+lJfyTc= +github.com/hashicorp/golang-lru v0.5.4/go.mod h1:iADmTwqILo4mZ8BN3D2Q6+9jd8WM5uGBxy+E8yxSoD4= +github.com/hashicorp/hcl v1.0.0/go.mod h1:E5yfLk+7swimpb2L/Alb/PJmXilQ/rhwaUYs4T20WEQ= +github.com/hpcloud/tail v1.0.0/go.mod h1:ab1qPbhIpdTxEkNHXyeSf5vhxWSCs/tWer42PpOxQnU= +github.com/huin/goupnp v1.0.0/go.mod h1:n9v9KO1tAxYH82qOn+UTIFQDmx5n1Zxd/ClZDMX7Bnc= +github.com/huin/goutil v0.0.0-20170803182201-1ca381bf3150/go.mod h1:PpLOETDnJ0o3iZrZfqZzyLl6l7F3c6L1oWn7OICBi6o= +github.com/inconshreveable/mousetrap v1.0.0/go.mod h1:PxqpIevigyE2G7u3NXJIT2ANytuPF1OarO4DADm73n8= +github.com/ipfs/bbloom v0.0.1/go.mod h1:oqo8CVWsJFMOZqTglBG4wydCE4IQA/G2/SEofB0rjUI= +github.com/ipfs/bbloom v0.0.4 h1:Gi+8EGJ2y5qiD5FbsbpX/TMNcJw8gSqr7eyjHa4Fhvs= +github.com/ipfs/bbloom v0.0.4/go.mod h1:cS9YprKXpoZ9lT0n/Mw/a6/aFV6DTjTLYHeA+gyqMG0= +github.com/ipfs/go-bitswap v0.3.4/go.mod h1:4T7fvNv/LmOys+21tnLzGKncMeeXUYUd1nUiJ2teMvI= +github.com/ipfs/go-block-format v0.0.1/go.mod h1:DK/YYcsSUIVAFNwo/KZCdIIbpN0ROH/baNLgayt4pFc= +github.com/ipfs/go-block-format v0.0.2/go.mod h1:AWR46JfpcObNfg3ok2JHDUfdiHRgWhJgCQF+KIgOPJY= +github.com/ipfs/go-block-format v0.0.3 h1:r8t66QstRp/pd/or4dpnbVfXT5Gt7lOqRvC+/dDTpMc= +github.com/ipfs/go-block-format v0.0.3/go.mod h1:4LmD4ZUw0mhO+JSKdpWwrzATiEfM7WWgQ8H5l6P8MVk= +github.com/ipfs/go-blockservice v0.1.7 h1:yVe9te0M7ow8i+PPkx03YFSpxqzXx594d6h+34D6qMg= +github.com/ipfs/go-blockservice v0.1.7/go.mod h1:GmS+BAt4hrwBKkzE11AFDQUrnvqjwFatGS2MY7wOjEM= +github.com/ipfs/go-cid v0.0.1/go.mod h1:GHWU/WuQdMPmIosc4Yn1bcCT7dSeX4lBafM7iqUPQvM= +github.com/ipfs/go-cid v0.0.2/go.mod h1:GHWU/WuQdMPmIosc4Yn1bcCT7dSeX4lBafM7iqUPQvM= +github.com/ipfs/go-cid v0.0.3/go.mod h1:GHWU/WuQdMPmIosc4Yn1bcCT7dSeX4lBafM7iqUPQvM= +github.com/ipfs/go-cid v0.0.4/go.mod h1:4LLaPOQwmk5z9LBgQnpkivrx8BJjUyGwTXCd5Xfj6+M= +github.com/ipfs/go-cid v0.0.5/go.mod h1:plgt+Y5MnOey4vO4UlUazGqdbEXuFYitED67FexhXog= +github.com/ipfs/go-cid v0.0.6/go.mod h1:6Ux9z5e+HpkQdckYoX1PG/6xqKspzlEIR5SDmgqgC/I= +github.com/ipfs/go-cid v0.0.7/go.mod h1:6Ux9z5e+HpkQdckYoX1PG/6xqKspzlEIR5SDmgqgC/I= +github.com/ipfs/go-cid v0.1.0 h1:YN33LQulcRHjfom/i25yoOZR4Telp1Hr/2RU3d0PnC0= +github.com/ipfs/go-cid v0.1.0/go.mod h1:rH5/Xv83Rfy8Rw6xG+id3DYAMUVmem1MowoKwdXmN2o= +github.com/ipfs/go-datastore v0.0.1/go.mod h1:d4KVXhMt913cLBEI/PXAy6ko+W7e9AhyAKBGh803qeE= +github.com/ipfs/go-datastore v0.1.1/go.mod h1:w38XXW9kVFNp57Zj5knbKWM2T+KOZCGDRVNdgPHtbHw= +github.com/ipfs/go-datastore v0.4.0/go.mod h1:SX/xMIKoCszPqp+z9JhPYCmoOoXTvaa13XEbGtsFUhA= +github.com/ipfs/go-datastore v0.4.1/go.mod h1:SX/xMIKoCszPqp+z9JhPYCmoOoXTvaa13XEbGtsFUhA= +github.com/ipfs/go-datastore v0.4.4/go.mod h1:SX/xMIKoCszPqp+z9JhPYCmoOoXTvaa13XEbGtsFUhA= +github.com/ipfs/go-datastore v0.4.5 h1:cwOUcGMLdLPWgu3SlrCckCMznaGADbPqE0r8h768/Dg= +github.com/ipfs/go-datastore v0.4.5/go.mod h1:eXTcaaiN6uOlVCLS9GjJUJtlvJfM3xk23w3fyfrmmJs= +github.com/ipfs/go-detect-race v0.0.1/go.mod h1:8BNT7shDZPo99Q74BpGMK+4D8Mn4j46UU0LZ723meps= +github.com/ipfs/go-ds-badger v0.0.2/go.mod h1:Y3QpeSFWQf6MopLTiZD+VT6IC1yZqaGmjvRcKeSGij8= +github.com/ipfs/go-ds-badger v0.0.5/go.mod h1:g5AuuCGmr7efyzQhLL8MzwqcauPojGPUaHzfGTzuE3s= +github.com/ipfs/go-ds-badger v0.2.1/go.mod h1:Tx7l3aTph3FMFrRS838dcSJh+jjA7cX9DrGVwx/NOwE= +github.com/ipfs/go-ds-badger v0.2.3/go.mod h1:pEYw0rgg3FIrywKKnL+Snr+w/LjJZVMTBRn4FS6UHUk= +github.com/ipfs/go-ds-leveldb v0.0.1/go.mod h1:feO8V3kubwsEF22n0YRQCffeb79OOYIykR4L04tMOYc= +github.com/ipfs/go-ds-leveldb v0.4.1/go.mod h1:jpbku/YqBSsBc1qgME8BkWS4AxzF2cEu1Ii2r79Hh9s= +github.com/ipfs/go-ds-leveldb v0.4.2/go.mod h1:jpbku/YqBSsBc1qgME8BkWS4AxzF2cEu1Ii2r79Hh9s= +github.com/ipfs/go-ipfs-blockstore v0.0.1/go.mod h1:d3WClOmRQKFnJ0Jz/jj/zmksX0ma1gROTlovZKBmN08= +github.com/ipfs/go-ipfs-blockstore v0.1.4/go.mod h1:Jxm3XMVjh6R17WvxFEiyKBLUGr86HgIYJW/D/MwqeYQ= +github.com/ipfs/go-ipfs-blockstore v0.1.6 h1:+RNM/gkTF6lzLPtt/xqjEUXJuG0lFwAiv+MV8MoAhvA= +github.com/ipfs/go-ipfs-blockstore v0.1.6/go.mod h1:Jxm3XMVjh6R17WvxFEiyKBLUGr86HgIYJW/D/MwqeYQ= +github.com/ipfs/go-ipfs-blocksutil v0.0.1 h1:Eh/H4pc1hsvhzsQoMEP3Bke/aW5P5rVM1IWFJMcGIPQ= +github.com/ipfs/go-ipfs-blocksutil v0.0.1/go.mod h1:Yq4M86uIOmxmGPUHv/uI7uKqZNtLb449gwKqXjIsnRk= +github.com/ipfs/go-ipfs-delay v0.0.0-20181109222059-70721b86a9a8/go.mod h1:8SP1YXK1M1kXuc4KJZINY3TQQ03J2rwBG9QfXmbRPrw= +github.com/ipfs/go-ipfs-delay v0.0.1/go.mod h1:8SP1YXK1M1kXuc4KJZINY3TQQ03J2rwBG9QfXmbRPrw= +github.com/ipfs/go-ipfs-ds-help v0.0.1/go.mod h1:gtP9xRaZXqIQRh1HRpp595KbBEdgqWFxefeVKOV8sxo= +github.com/ipfs/go-ipfs-ds-help v0.1.1 h1:IW/bXGeaAZV2VH0Kuok+Ohva/zHkHmeLFBxC1k7mNPc= +github.com/ipfs/go-ipfs-ds-help v0.1.1/go.mod h1:SbBafGJuGsPI/QL3j9Fc5YPLeAu+SzOkI0gFwAg+mOs= +github.com/ipfs/go-ipfs-exchange-interface v0.0.1 h1:LJXIo9W7CAmugqI+uofioIpRb6rY30GUu7G6LUfpMvM= +github.com/ipfs/go-ipfs-exchange-interface v0.0.1/go.mod h1:c8MwfHjtQjPoDyiy9cFquVtVHkO9b9Ob3FG91qJnWCM= +github.com/ipfs/go-ipfs-exchange-offline v0.0.1 h1:P56jYKZF7lDDOLx5SotVh5KFxoY6C81I1NSHW1FxGew= +github.com/ipfs/go-ipfs-exchange-offline v0.0.1/go.mod h1:WhHSFCVYX36H/anEKQboAzpUws3x7UeEGkzQc3iNkM0= +github.com/ipfs/go-ipfs-pq v0.0.2/go.mod h1:LWIqQpqfRG3fNc5XsnIhz/wQ2XXGyugQwls7BgUmUfY= +github.com/ipfs/go-ipfs-routing v0.1.0/go.mod h1:hYoUkJLyAUKhF58tysKpids8RNDPO42BVMgK5dNsoqY= +github.com/ipfs/go-ipfs-util v0.0.1/go.mod h1:spsl5z8KUnrve+73pOhSVZND1SIxPW5RyBCNzQxlJBc= +github.com/ipfs/go-ipfs-util v0.0.2 h1:59Sswnk1MFaiq+VcaknX7aYEyGyGDAA73ilhEK2POp8= +github.com/ipfs/go-ipfs-util v0.0.2/go.mod h1:CbPtkWJzjLdEcezDns2XYaehFVNXG9zrdrtMecczcsQ= +github.com/ipfs/go-log v0.0.1/go.mod h1:kL1d2/hzSpI0thNYjiKfjanbVNU+IIGA/WnNESY9leM= +github.com/ipfs/go-log v1.0.2/go.mod h1:1MNjMxe0u6xvJZgeqbJ8vdo2TKaGwZ1a0Bpza+sr2Sk= +github.com/ipfs/go-log v1.0.3/go.mod h1:OsLySYkwIbiSUR/yBTdv1qPtcE4FW3WPWk/ewz9Ru+A= +github.com/ipfs/go-log v1.0.4/go.mod h1:oDCg2FkjogeFOhqqb+N39l2RpTNPL6F/StPkB3kPgcs= +github.com/ipfs/go-log v1.0.5 h1:2dOuUCB1Z7uoczMWgAyDck5JLb72zHzrMnGnCNNbvY8= +github.com/ipfs/go-log v1.0.5/go.mod h1:j0b8ZoR+7+R99LD9jZ6+AJsrzkPbSXbZfGakb5JPtIo= +github.com/ipfs/go-log/v2 v2.0.2/go.mod h1:O7P1lJt27vWHhOwQmcFEvlmo49ry2VY2+JfBWFaa9+0= +github.com/ipfs/go-log/v2 v2.0.3/go.mod h1:O7P1lJt27vWHhOwQmcFEvlmo49ry2VY2+JfBWFaa9+0= +github.com/ipfs/go-log/v2 v2.0.5/go.mod h1:eZs4Xt4ZUJQFM3DlanGhy7TkwwawCZcSByscwkWG+dw= +github.com/ipfs/go-log/v2 v2.1.1/go.mod h1:2v2nsGfZsvvAJz13SyFzf9ObaqwHiHxsPLEHntrv9KM= +github.com/ipfs/go-log/v2 v2.1.3 h1:1iS3IU7aXRlbgUpN8yTTpJ53NXYjAe37vcI5+5nYrzk= +github.com/ipfs/go-log/v2 v2.1.3/go.mod h1:/8d0SH3Su5Ooc31QlL1WysJhvyOTDCjcCZ9Axpmri6g= +github.com/ipfs/go-metrics-interface v0.0.1 h1:j+cpbjYvu4R8zbleSs36gvB7jR+wsL2fGD6n0jO4kdg= +github.com/ipfs/go-metrics-interface v0.0.1/go.mod h1:6s6euYU4zowdslK0GKHmqaIZ3j/b/tL7HTWtJ4VPgWY= +github.com/ipfs/go-peertaskqueue v0.2.0/go.mod h1:5/eNrBEbtSKWCG+kQK8K8fGNixoYUnr+P7jivavs9lY= +github.com/ipfs/go-verifcid v0.0.1 h1:m2HI7zIuR5TFyQ1b79Da5N9dnnCP1vcu2QqawmWlK2E= +github.com/ipfs/go-verifcid v0.0.1/go.mod h1:5Hrva5KBeIog4A+UpqlaIU+DEstipcJYQQZc0g37pY0= +github.com/jackpal/gateway v1.0.5/go.mod h1:lTpwd4ACLXmpyiCTRtfiNyVnUmqT9RivzCDQetPfnjA= +github.com/jackpal/go-nat-pmp v1.0.1/go.mod h1:QPH045xvCAeXUZOxsnwmrtiCoxIr9eob+4orBN1SBKc= +github.com/jackpal/go-nat-pmp v1.0.2/go.mod h1:QPH045xvCAeXUZOxsnwmrtiCoxIr9eob+4orBN1SBKc= +github.com/jbenet/go-cienv v0.0.0-20150120210510-1bb1476777ec/go.mod h1:rGaEvXB4uRSZMmzKNLoXvTu1sfx+1kv/DojUlPrSZGs= +github.com/jbenet/go-cienv v0.1.0/go.mod h1:TqNnHUmJgXau0nCzC7kXWeotg3J9W34CUv5Djy1+FlA= +github.com/jbenet/go-temp-err-catcher v0.0.0-20150120210811-aac704a3f4f2/go.mod h1:8GXXJV31xl8whumTzdZsTt3RnUIiPqzkyf7mxToRCMs= +github.com/jbenet/go-temp-err-catcher v0.1.0/go.mod h1:0kJRvmDZXNMIiJirNPEYfhpPwbGVtZVWC34vc5WLsDk= +github.com/jbenet/goprocess v0.0.0-20160826012719-b497e2f366b8/go.mod h1:Ly/wlsjFq/qrU3Rar62tu1gASgGw6chQbSh/XgIIXCY= +github.com/jbenet/goprocess v0.1.3/go.mod h1:5yspPrukOVuOLORacaBi858NqyClJPQxYZlqdZVfqY4= +github.com/jbenet/goprocess v0.1.4 h1:DRGOFReOMqqDNXwW70QkacFW0YN9QnwLV0Vqk+3oU0o= +github.com/jbenet/goprocess v0.1.4/go.mod h1:5yspPrukOVuOLORacaBi858NqyClJPQxYZlqdZVfqY4= +github.com/jellevandenhooff/dkim v0.0.0-20150330215556-f50fe3d243e1/go.mod h1:E0B/fFc00Y+Rasa88328GlI/XbtyysCtTHZS8h7IrBU= +github.com/jessevdk/go-flags v0.0.0-20141203071132-1679536dcc89/go.mod h1:4FA24M0QyGHXBuZZK/XkWh8h0e1EYbRYJSGM75WSRxI= +github.com/jessevdk/go-flags v1.4.0/go.mod h1:4FA24M0QyGHXBuZZK/XkWh8h0e1EYbRYJSGM75WSRxI= +github.com/jrick/logrotate v1.0.0/go.mod h1:LNinyqDIJnpAur+b8yyulnQw/wDuN1+BYKlTRt3OuAQ= +github.com/json-iterator/go v1.1.6/go.mod h1:+SdeFBvtyEkXs7REEP0seUULqWtbJapLOCVDaaPEHmU= +github.com/jstemmer/go-junit-report v0.0.0-20190106144839-af01ea7f8024/go.mod h1:6v2b51hI/fHJwM22ozAgKL4VKDeJcHhJFhtBdhmNjmU= +github.com/kami-zh/go-capturer v0.0.0-20171211120116-e492ea43421d/go.mod h1:P2viExyCEfeWGU259JnaQ34Inuec4R38JCyBx2edgD0= +github.com/kisielk/errcheck v1.1.0/go.mod h1:EZBBE59ingxPouuu3KfxchcWSUPOHkagtvWXihfKN4Q= +github.com/kisielk/errcheck v1.2.0/go.mod h1:/BMXB+zMLi60iA8Vv6Ksmxu/1UDYcXs4uQLJ+jE2L00= +github.com/kisielk/errcheck v1.5.0/go.mod h1:pFxgyoBC7bSaBwPgfKdkLd5X25qrDl4LWUI2bnpBCr8= +github.com/kisielk/gotool v1.0.0/go.mod h1:XhKaO+MFFWcvkIS/tQcRk01m1F5IRFswLeQ+oQHNcck= +github.com/kkdai/bstream v0.0.0-20161212061736-f391b8402d23/go.mod h1:J+Gs4SYgM6CZQHDETBtE9HaSEkGmuNXF86RwHhHUvq4= +github.com/klauspost/cpuid/v2 v2.0.4/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/klauspost/cpuid/v2 v2.0.6 h1:dQ5ueTiftKxp0gyjKSx5+8BtPWkyQbd95m8Gys/RarI= +github.com/klauspost/cpuid/v2 v2.0.6/go.mod h1:FInQzS24/EEf25PyTYn52gqo7WaD8xa0213Md/qVLRg= +github.com/konsorten/go-windows-terminal-sequences v1.0.1/go.mod h1:T0+1ngSBFLxvqU3pZ+m/2kptfBszLMUkC4ZK/EgS/cQ= +github.com/koron/go-ssdp v0.0.0-20191105050749-2e1c40ed0b5d/go.mod h1:5Ky9EC2xfoUKUor0Hjgi2BJhCSXJfMOFlmyYrVKGQMk= +github.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo= +github.com/kr/pretty v0.2.0/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI= +github.com/kr/pretty v0.2.1 h1:Fmg33tUaq4/8ym9TJN1x7sLJnHVwhP33CNkpYV/7rwI= +github.com/kr/pretty v0.2.1/go.mod h1:ipq/a2n7PKx3OHsz4KJII5eveXtPO4qwEXGdVfWzfnI= +github.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= +github.com/kr/pty v1.1.3/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ= +github.com/kr/text v0.1.0 h1:45sCR5RtlFHMR4UwH9sdQ5TC8v0qDQCHnXt+kaKSTVE= +github.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI= +github.com/libp2p/go-addr-util v0.0.1/go.mod h1:4ac6O7n9rIAKB1dnd+s8IbbMXkt+oBpzX4/+RACcnlQ= +github.com/libp2p/go-addr-util v0.0.2/go.mod h1:Ecd6Fb3yIuLzq4bD7VcywcVSBtefcAwnUISBM3WG15E= +github.com/libp2p/go-buffer-pool v0.0.1/go.mod h1:xtyIz9PMobb13WaxR6Zo1Pd1zXJKYg0a8KiIvDp3TzQ= +github.com/libp2p/go-buffer-pool v0.0.2/go.mod h1:MvaB6xw5vOrDl8rYZGLFdKAuk/hRoRZd1Vi32+RXyFM= +github.com/libp2p/go-conn-security-multistream v0.1.0/go.mod h1:aw6eD7LOsHEX7+2hJkDxw1MteijaVcI+/eP2/x3J1xc= +github.com/libp2p/go-conn-security-multistream v0.2.0/go.mod h1:hZN4MjlNetKD3Rq5Jb/P5ohUnFLNzEAR4DLSzpn2QLU= +github.com/libp2p/go-conn-security-multistream v0.2.1/go.mod h1:cR1d8gA0Hr59Fj6NhaTpFhJZrjSYuNmhpT2r25zYR70= +github.com/libp2p/go-eventbus v0.1.0/go.mod h1:vROgu5cs5T7cv7POWlWxBaVLxfSegC5UGQf8A2eEmx4= +github.com/libp2p/go-eventbus v0.2.1/go.mod h1:jc2S4SoEVPP48H9Wpzm5aiGwUCBMfGhVhhBjyhhCJs8= +github.com/libp2p/go-flow-metrics v0.0.1/go.mod h1:Iv1GH0sG8DtYN3SVJ2eG221wMiNpZxBdp967ls1g+k8= +github.com/libp2p/go-flow-metrics v0.0.3/go.mod h1:HeoSNUrOJVK1jEpDqVEiUOIXqhbnS27omG0uWU5slZs= +github.com/libp2p/go-libp2p v0.6.1/go.mod h1:CTFnWXogryAHjXAKEbOf1OWY+VeAP3lDMZkfEI5sT54= +github.com/libp2p/go-libp2p v0.7.0/go.mod h1:hZJf8txWeCduQRDC/WSqBGMxaTHCOYHt2xSU1ivxn0k= +github.com/libp2p/go-libp2p v0.7.4/go.mod h1:oXsBlTLF1q7pxr+9w6lqzS1ILpyHsaBPniVO7zIHGMw= +github.com/libp2p/go-libp2p v0.8.1/go.mod h1:QRNH9pwdbEBpx5DTJYg+qxcVaDMAz3Ee/qDKwXujH5o= +github.com/libp2p/go-libp2p v0.13.0/go.mod h1:pM0beYdACRfHO1WcJlp65WXyG2A6NqYM+t2DTVAJxMo= +github.com/libp2p/go-libp2p v0.14.0/go.mod h1:dsQrWLAoIn+GkHPN/U+yypizkHiB9tnv79Os+kSgQ4Q= +github.com/libp2p/go-libp2p-autonat v0.1.1/go.mod h1:OXqkeGOY2xJVWKAGV2inNF5aKN/djNA3fdpCWloIudE= +github.com/libp2p/go-libp2p-autonat v0.2.0/go.mod h1:DX+9teU4pEEoZUqR1PiMlqliONQdNbfzE1C718tcViI= +github.com/libp2p/go-libp2p-autonat v0.2.1/go.mod h1:MWtAhV5Ko1l6QBsHQNSuM6b1sRkXrpk0/LqCr+vCVxI= +github.com/libp2p/go-libp2p-autonat v0.2.2/go.mod h1:HsM62HkqZmHR2k1xgX34WuWDzk/nBwNHoeyyT4IWV6A= +github.com/libp2p/go-libp2p-autonat v0.4.0/go.mod h1:YxaJlpr81FhdOv3W3BTconZPfhaYivRdf53g+S2wobk= +github.com/libp2p/go-libp2p-autonat v0.4.2/go.mod h1:YxaJlpr81FhdOv3W3BTconZPfhaYivRdf53g+S2wobk= +github.com/libp2p/go-libp2p-blankhost v0.1.1/go.mod h1:pf2fvdLJPsC1FsVrNP3DUUvMzUts2dsLLBEpo1vW1ro= +github.com/libp2p/go-libp2p-blankhost v0.1.4/go.mod h1:oJF0saYsAXQCSfDq254GMNmLNz6ZTHTOvtF4ZydUvwU= +github.com/libp2p/go-libp2p-blankhost v0.2.0/go.mod h1:eduNKXGTioTuQAUcZ5epXi9vMl+t4d8ugUBRQ4SqaNQ= +github.com/libp2p/go-libp2p-circuit v0.1.4/go.mod h1:CY67BrEjKNDhdTk8UgBX1Y/H5c3xkAcs3gnksxY7osU= +github.com/libp2p/go-libp2p-circuit v0.2.1/go.mod h1:BXPwYDN5A8z4OEY9sOfr2DUQMLQvKt/6oku45YUmjIo= +github.com/libp2p/go-libp2p-circuit v0.4.0/go.mod h1:t/ktoFIUzM6uLQ+o1G6NuBl2ANhBKN9Bc8jRIk31MoA= +github.com/libp2p/go-libp2p-core v0.0.1/go.mod h1:g/VxnTZ/1ygHxH3dKok7Vno1VfpvGcGip57wjTU4fco= +github.com/libp2p/go-libp2p-core v0.0.2/go.mod h1:9dAcntw/n46XycV4RnlBq3BpgrmyUi9LuoTNdPrbUco= +github.com/libp2p/go-libp2p-core v0.0.4/go.mod h1:jyuCQP356gzfCFtRKyvAbNkyeuxb7OlyhWZ3nls5d2I= +github.com/libp2p/go-libp2p-core v0.2.0/go.mod h1:X0eyB0Gy93v0DZtSYbEM7RnMChm9Uv3j7yRXjO77xSI= +github.com/libp2p/go-libp2p-core v0.2.2/go.mod h1:8fcwTbsG2B+lTgRJ1ICZtiM5GWCWZVoVrLaDRvIRng0= +github.com/libp2p/go-libp2p-core v0.2.4/go.mod h1:STh4fdfa5vDYr0/SzYYeqnt+E6KfEV5VxfIrm0bcI0g= +github.com/libp2p/go-libp2p-core v0.3.0/go.mod h1:ACp3DmS3/N64c2jDzcV429ukDpicbL6+TrrxANBjPGw= +github.com/libp2p/go-libp2p-core v0.3.1/go.mod h1:thvWy0hvaSBhnVBaW37BvzgVV68OUhgJJLAa6almrII= +github.com/libp2p/go-libp2p-core v0.4.0/go.mod h1:49XGI+kc38oGVwqSBhDEwytaAxgZasHhFfQKibzTls0= +github.com/libp2p/go-libp2p-core v0.5.0/go.mod h1:49XGI+kc38oGVwqSBhDEwytaAxgZasHhFfQKibzTls0= +github.com/libp2p/go-libp2p-core v0.5.1/go.mod h1:uN7L2D4EvPCvzSH5SrhR72UWbnSGpt5/a35Sm4upn4Y= +github.com/libp2p/go-libp2p-core v0.5.4/go.mod h1:uN7L2D4EvPCvzSH5SrhR72UWbnSGpt5/a35Sm4upn4Y= +github.com/libp2p/go-libp2p-core v0.5.5/go.mod h1:vj3awlOr9+GMZJFH9s4mpt9RHHgGqeHCopzbYKZdRjM= +github.com/libp2p/go-libp2p-core v0.5.6/go.mod h1:txwbVEhHEXikXn9gfC7/UDDw7rkxuX0bJvM49Ykaswo= +github.com/libp2p/go-libp2p-core v0.5.7/go.mod h1:txwbVEhHEXikXn9gfC7/UDDw7rkxuX0bJvM49Ykaswo= +github.com/libp2p/go-libp2p-core v0.6.0/go.mod h1:txwbVEhHEXikXn9gfC7/UDDw7rkxuX0bJvM49Ykaswo= +github.com/libp2p/go-libp2p-core v0.7.0/go.mod h1:FfewUH/YpvWbEB+ZY9AQRQ4TAD8sJBt/G1rVvhz5XT8= +github.com/libp2p/go-libp2p-core v0.8.0/go.mod h1:FfewUH/YpvWbEB+ZY9AQRQ4TAD8sJBt/G1rVvhz5XT8= +github.com/libp2p/go-libp2p-core v0.8.1/go.mod h1:FfewUH/YpvWbEB+ZY9AQRQ4TAD8sJBt/G1rVvhz5XT8= +github.com/libp2p/go-libp2p-core v0.8.2/go.mod h1:FfewUH/YpvWbEB+ZY9AQRQ4TAD8sJBt/G1rVvhz5XT8= +github.com/libp2p/go-libp2p-core v0.8.5/go.mod h1:FfewUH/YpvWbEB+ZY9AQRQ4TAD8sJBt/G1rVvhz5XT8= +github.com/libp2p/go-libp2p-crypto v0.1.0/go.mod h1:sPUokVISZiy+nNuTTH/TY+leRSxnFj/2GLjtOTW90hI= +github.com/libp2p/go-libp2p-discovery v0.2.0/go.mod h1:s4VGaxYMbw4+4+tsoQTqh7wfxg97AEdo4GYBt6BadWg= +github.com/libp2p/go-libp2p-discovery v0.3.0/go.mod h1:o03drFnz9BVAZdzC/QUQ+NeQOu38Fu7LJGEOK2gQltw= +github.com/libp2p/go-libp2p-discovery v0.5.0/go.mod h1:+srtPIU9gDaBNu//UHvcdliKBIcr4SfDcm0/PfPJLug= +github.com/libp2p/go-libp2p-loggables v0.1.0/go.mod h1:EyumB2Y6PrYjr55Q3/tiJ/o3xoDasoRYM7nOzEpoa90= +github.com/libp2p/go-libp2p-mplex v0.2.0/go.mod h1:Ejl9IyjvXJ0T9iqUTE1jpYATQ9NM3g+OtR+EMMODbKo= +github.com/libp2p/go-libp2p-mplex v0.2.1/go.mod h1:SC99Rxs8Vuzrf/6WhmH41kNn13TiYdAWNYHrwImKLnE= +github.com/libp2p/go-libp2p-mplex v0.2.2/go.mod h1:74S9eum0tVQdAfFiKxAyKzNdSuLqw5oadDq7+L/FELo= +github.com/libp2p/go-libp2p-mplex v0.2.3/go.mod h1:CK3p2+9qH9x+7ER/gWWDYJ3QW5ZxWDkm+dVvjfuG3ek= +github.com/libp2p/go-libp2p-mplex v0.4.0/go.mod h1:yCyWJE2sc6TBTnFpjvLuEJgTSw/u+MamvzILKdX7asw= +github.com/libp2p/go-libp2p-mplex v0.4.1/go.mod h1:cmy+3GfqfM1PceHTLL7zQzAAYaryDu6iPSC+CIb094g= +github.com/libp2p/go-libp2p-nat v0.0.5/go.mod h1:1qubaE5bTZMJE+E/uu2URroMbzdubFz1ChgiN79yKPE= +github.com/libp2p/go-libp2p-nat v0.0.6/go.mod h1:iV59LVhB3IkFvS6S6sauVTSOrNEANnINbI/fkaLimiw= +github.com/libp2p/go-libp2p-netutil v0.1.0/go.mod h1:3Qv/aDqtMLTUyQeundkKsA+YCThNdbQD54k3TqjpbFU= +github.com/libp2p/go-libp2p-noise v0.1.1/go.mod h1:QDFLdKX7nluB7DEnlVPbz7xlLHdwHFA9HiohJRr3vwM= +github.com/libp2p/go-libp2p-noise v0.2.0/go.mod h1:IEbYhBBzGyvdLBoxxULL/SGbJARhUeqlO8lVSREYu2Q= +github.com/libp2p/go-libp2p-peer v0.2.0/go.mod h1:RCffaCvUyW2CJmG2gAWVqwePwW7JMgxjsHm7+J5kjWY= +github.com/libp2p/go-libp2p-peerstore v0.1.0/go.mod h1:2CeHkQsr8svp4fZ+Oi9ykN1HBb6u0MOvdJ7YIsmcwtY= +github.com/libp2p/go-libp2p-peerstore v0.1.3/go.mod h1:BJ9sHlm59/80oSkpWgr1MyY1ciXAXV397W6h1GH/uKI= +github.com/libp2p/go-libp2p-peerstore v0.2.0/go.mod h1:N2l3eVIeAitSg3Pi2ipSrJYnqhVnMNQZo9nkSCuAbnQ= +github.com/libp2p/go-libp2p-peerstore v0.2.1/go.mod h1:NQxhNjWxf1d4w6PihR8btWIRjwRLBr4TYKfNgrUkOPA= +github.com/libp2p/go-libp2p-peerstore v0.2.2/go.mod h1:NQxhNjWxf1d4w6PihR8btWIRjwRLBr4TYKfNgrUkOPA= +github.com/libp2p/go-libp2p-peerstore v0.2.6/go.mod h1:ss/TWTgHZTMpsU/oKVVPQCGuDHItOpf2W8RxAi50P2s= +github.com/libp2p/go-libp2p-peerstore v0.2.7/go.mod h1:ss/TWTgHZTMpsU/oKVVPQCGuDHItOpf2W8RxAi50P2s= +github.com/libp2p/go-libp2p-pnet v0.2.0/go.mod h1:Qqvq6JH/oMZGwqs3N1Fqhv8NVhrdYcO0BW4wssv21LA= +github.com/libp2p/go-libp2p-quic-transport v0.10.0/go.mod h1:RfJbZ8IqXIhxBRm5hqUEJqjiiY8xmEuq3HUDS993MkA= +github.com/libp2p/go-libp2p-record v0.1.0/go.mod h1:ujNc8iuE5dlKWVy6wuL6dd58t0n7xI4hAIl8pE6wu5Q= +github.com/libp2p/go-libp2p-secio v0.1.0/go.mod h1:tMJo2w7h3+wN4pgU2LSYeiKPrfqBgkOsdiKK77hE7c8= +github.com/libp2p/go-libp2p-secio v0.2.0/go.mod h1:2JdZepB8J5V9mBp79BmwsaPQhRPNN2NrnB2lKQcdy6g= +github.com/libp2p/go-libp2p-secio v0.2.1/go.mod h1:cWtZpILJqkqrSkiYcDBh5lA3wbT2Q+hz3rJQq3iftD8= +github.com/libp2p/go-libp2p-secio v0.2.2/go.mod h1:wP3bS+m5AUnFA+OFO7Er03uO1mncHG0uVwGrwvjYlNY= +github.com/libp2p/go-libp2p-swarm v0.1.0/go.mod h1:wQVsCdjsuZoc730CgOvh5ox6K8evllckjebkdiY5ta4= +github.com/libp2p/go-libp2p-swarm v0.2.2/go.mod h1:fvmtQ0T1nErXym1/aa1uJEyN7JzaTNyBcHImCxRpPKU= +github.com/libp2p/go-libp2p-swarm v0.2.3/go.mod h1:P2VO/EpxRyDxtChXz/VPVXyTnszHvokHKRhfkEgFKNM= +github.com/libp2p/go-libp2p-swarm v0.2.8/go.mod h1:JQKMGSth4SMqonruY0a8yjlPVIkb0mdNSwckW7OYziM= +github.com/libp2p/go-libp2p-swarm v0.3.0/go.mod h1:hdv95GWCTmzkgeJpP+GK/9D9puJegb7H57B5hWQR5Kk= +github.com/libp2p/go-libp2p-swarm v0.4.0/go.mod h1:XVFcO52VoLoo0eitSxNQWYq4D6sydGOweTOAjJNraCw= +github.com/libp2p/go-libp2p-swarm v0.5.0/go.mod h1:sU9i6BoHE0Ve5SKz3y9WfKrh8dUat6JknzUehFx8xW4= +github.com/libp2p/go-libp2p-testing v0.0.2/go.mod h1:gvchhf3FQOtBdr+eFUABet5a4MBLK8jM3V4Zghvmi+E= +github.com/libp2p/go-libp2p-testing v0.0.3/go.mod h1:gvchhf3FQOtBdr+eFUABet5a4MBLK8jM3V4Zghvmi+E= +github.com/libp2p/go-libp2p-testing v0.0.4/go.mod h1:gvchhf3FQOtBdr+eFUABet5a4MBLK8jM3V4Zghvmi+E= +github.com/libp2p/go-libp2p-testing v0.1.0/go.mod h1:xaZWMJrPUM5GlDBxCeGUi7kI4eqnjVyavGroI2nxEM0= +github.com/libp2p/go-libp2p-testing v0.1.1/go.mod h1:xaZWMJrPUM5GlDBxCeGUi7kI4eqnjVyavGroI2nxEM0= +github.com/libp2p/go-libp2p-testing v0.1.2-0.20200422005655-8775583591d8/go.mod h1:Qy8sAncLKpwXtS2dSnDOP8ktexIAHKu+J+pnZOFZLTc= +github.com/libp2p/go-libp2p-testing v0.3.0/go.mod h1:efZkql4UZ7OVsEfaxNHZPzIehtsBXMrXnCfJIgDti5g= +github.com/libp2p/go-libp2p-testing v0.4.0/go.mod h1:Q+PFXYoiYFN5CAEG2w3gLPEzotlKsNSbKQ/lImlOWF0= +github.com/libp2p/go-libp2p-tls v0.1.3/go.mod h1:wZfuewxOndz5RTnCAxFliGjvYSDA40sKitV4c50uI1M= +github.com/libp2p/go-libp2p-transport-upgrader v0.1.1/go.mod h1:IEtA6or8JUbsV07qPW4r01GnTenLW4oi3lOPbUMGJJA= +github.com/libp2p/go-libp2p-transport-upgrader v0.2.0/go.mod h1:mQcrHj4asu6ArfSoMuyojOdjx73Q47cYD7s5+gZOlns= +github.com/libp2p/go-libp2p-transport-upgrader v0.3.0/go.mod h1:i+SKzbRnvXdVbU3D1dwydnTmKRPXiAR/fyvi1dXuL4o= +github.com/libp2p/go-libp2p-transport-upgrader v0.4.0/go.mod h1:J4ko0ObtZSmgn5BX5AmegP+dK3CSnU2lMCKsSq/EY0s= +github.com/libp2p/go-libp2p-transport-upgrader v0.4.2/go.mod h1:NR8ne1VwfreD5VIWIU62Agt/J18ekORFU/j1i2y8zvk= +github.com/libp2p/go-libp2p-yamux v0.2.0/go.mod h1:Db2gU+XfLpm6E4rG5uGCFX6uXA8MEXOxFcRoXUODaK8= +github.com/libp2p/go-libp2p-yamux v0.2.2/go.mod h1:lIohaR0pT6mOt0AZ0L2dFze9hds9Req3OfS+B+dv4qw= +github.com/libp2p/go-libp2p-yamux v0.2.5/go.mod h1:Zpgj6arbyQrmZ3wxSZxfBmbdnWtbZ48OpsfmQVTErwA= +github.com/libp2p/go-libp2p-yamux v0.2.7/go.mod h1:X28ENrBMU/nm4I3Nx4sZ4dgjZ6VhLEn0XhIoZ5viCwU= +github.com/libp2p/go-libp2p-yamux v0.2.8/go.mod h1:/t6tDqeuZf0INZMTgd0WxIRbtK2EzI2h7HbFm9eAKI4= +github.com/libp2p/go-libp2p-yamux v0.4.0/go.mod h1:+DWDjtFMzoAwYLVkNZftoucn7PelNoy5nm3tZ3/Zw30= +github.com/libp2p/go-libp2p-yamux v0.5.0/go.mod h1:AyR8k5EzyM2QN9Bbdg6X1SkVVuqLwTGf0L4DFq9g6po= +github.com/libp2p/go-libp2p-yamux v0.5.1/go.mod h1:dowuvDu8CRWmr0iqySMiSxK+W0iL5cMVO9S94Y6gkv4= +github.com/libp2p/go-libp2p-yamux v0.5.3/go.mod h1:Vy3TMonBAfTMXHWopsMc8iX/XGRYrRlpUaMzaeuHV/s= +github.com/libp2p/go-maddr-filter v0.0.4/go.mod h1:6eT12kSQMA9x2pvFQa+xesMKUBlj9VImZbj3B9FBH/Q= +github.com/libp2p/go-maddr-filter v0.0.5/go.mod h1:Jk+36PMfIqCJhAnaASRH83bdAvfDRp/w6ENFaC9bG+M= +github.com/libp2p/go-maddr-filter v0.1.0/go.mod h1:VzZhTXkMucEGGEOSKddrwGiOv0tUhgnKqNEmIAz/bPU= +github.com/libp2p/go-mplex v0.0.3/go.mod h1:pK5yMLmOoBR1pNCqDlA2GQrdAVTMkqFalaTWe7l4Yd0= +github.com/libp2p/go-mplex v0.1.0/go.mod h1:SXgmdki2kwCUlCCbfGLEgHjC4pFqhTp0ZoV6aiKgxDU= +github.com/libp2p/go-mplex v0.1.1/go.mod h1:Xgz2RDCi3co0LeZfgjm4OgUF15+sVR8SRcu3SFXI1lk= +github.com/libp2p/go-mplex v0.1.2/go.mod h1:Xgz2RDCi3co0LeZfgjm4OgUF15+sVR8SRcu3SFXI1lk= +github.com/libp2p/go-mplex v0.2.0/go.mod h1:0Oy/A9PQlwBytDRp4wSkFnzHYDKcpLot35JQ6msjvYQ= +github.com/libp2p/go-mplex v0.3.0/go.mod h1:0Oy/A9PQlwBytDRp4wSkFnzHYDKcpLot35JQ6msjvYQ= +github.com/libp2p/go-msgio v0.0.2/go.mod h1:63lBBgOTDKQL6EWazRMCwXsEeEeK9O2Cd+0+6OOuipQ= +github.com/libp2p/go-msgio v0.0.4/go.mod h1:63lBBgOTDKQL6EWazRMCwXsEeEeK9O2Cd+0+6OOuipQ= +github.com/libp2p/go-msgio v0.0.6/go.mod h1:4ecVB6d9f4BDSL5fqvPiC4A3KivjWn+Venn/1ALLMWA= +github.com/libp2p/go-nat v0.0.4/go.mod h1:Nmw50VAvKuk38jUBcmNh6p9lUJLoODbJRvYAa/+KSDo= +github.com/libp2p/go-nat v0.0.5/go.mod h1:B7NxsVNPZmRLvMOwiEO1scOSyjA56zxYAGv1yQgRkEU= +github.com/libp2p/go-netroute v0.1.2/go.mod h1:jZLDV+1PE8y5XxBySEBgbuVAXbhtuHSdmLPL2n9MKbk= +github.com/libp2p/go-netroute v0.1.3/go.mod h1:jZLDV+1PE8y5XxBySEBgbuVAXbhtuHSdmLPL2n9MKbk= +github.com/libp2p/go-netroute v0.1.6/go.mod h1:AqhkMh0VuWmfgtxKPp3Oc1LdU5QSWS7wl0QLhSZqXxQ= +github.com/libp2p/go-openssl v0.0.2/go.mod h1:v8Zw2ijCSWBQi8Pq5GAixw6DbFfa9u6VIYDXnvOXkc0= +github.com/libp2p/go-openssl v0.0.3/go.mod h1:unDrJpgy3oFr+rqXsarWifmJuNnJR4chtO1HmaZjggc= +github.com/libp2p/go-openssl v0.0.4/go.mod h1:unDrJpgy3oFr+rqXsarWifmJuNnJR4chtO1HmaZjggc= +github.com/libp2p/go-openssl v0.0.5/go.mod h1:unDrJpgy3oFr+rqXsarWifmJuNnJR4chtO1HmaZjggc= +github.com/libp2p/go-openssl v0.0.7/go.mod h1:unDrJpgy3oFr+rqXsarWifmJuNnJR4chtO1HmaZjggc= +github.com/libp2p/go-reuseport v0.0.1/go.mod h1:jn6RmB1ufnQwl0Q1f+YxAj8isJgDCQzaaxIFYDhcYEA= +github.com/libp2p/go-reuseport v0.0.2/go.mod h1:SPD+5RwGC7rcnzngoYC86GjPzjSywuQyMVAheVBD9nQ= +github.com/libp2p/go-reuseport-transport v0.0.2/go.mod h1:YkbSDrvjUVDL6b8XqriyA20obEtsW9BLkuOUyQAOCbs= +github.com/libp2p/go-reuseport-transport v0.0.3/go.mod h1:Spv+MPft1exxARzP2Sruj2Wb5JSyHNncjf1Oi2dEbzM= +github.com/libp2p/go-reuseport-transport v0.0.4/go.mod h1:trPa7r/7TJK/d+0hdBLOCGvpQQVOU74OXbNCIMkufGw= +github.com/libp2p/go-sockaddr v0.0.2/go.mod h1:syPvOmNs24S3dFVGJA1/mrqdeijPxLV2Le3BRLKd68k= +github.com/libp2p/go-sockaddr v0.1.1/go.mod h1:syPvOmNs24S3dFVGJA1/mrqdeijPxLV2Le3BRLKd68k= +github.com/libp2p/go-stream-muxer v0.0.1/go.mod h1:bAo8x7YkSpadMTbtTaxGVHWUQsR/l5MEaHbKaliuT14= +github.com/libp2p/go-stream-muxer-multistream v0.2.0/go.mod h1:j9eyPol/LLRqT+GPLSxvimPhNph4sfYfMoDPd7HkzIc= +github.com/libp2p/go-stream-muxer-multistream v0.3.0/go.mod h1:yDh8abSIzmZtqtOt64gFJUXEryejzNb0lisTt+fAMJA= +github.com/libp2p/go-tcp-transport v0.1.0/go.mod h1:oJ8I5VXryj493DEJ7OsBieu8fcg2nHGctwtInJVpipc= +github.com/libp2p/go-tcp-transport v0.1.1/go.mod h1:3HzGvLbx6etZjnFlERyakbaYPdfjg2pWP97dFZworkY= +github.com/libp2p/go-tcp-transport v0.2.0/go.mod h1:vX2U0CnWimU4h0SGSEsg++AzvBcroCGYw28kh94oLe0= +github.com/libp2p/go-tcp-transport v0.2.1/go.mod h1:zskiJ70MEfWz2MKxvFB/Pv+tPIB1PpPUrHIWQ8aFw7M= +github.com/libp2p/go-ws-transport v0.2.0/go.mod h1:9BHJz/4Q5A9ludYWKoGCFC5gUElzlHoKzu0yY9p/klM= +github.com/libp2p/go-ws-transport v0.3.0/go.mod h1:bpgTJmRZAvVHrgHybCVyqoBmyLQ1fiZuEaBYusP5zsk= +github.com/libp2p/go-ws-transport v0.4.0/go.mod h1:EcIEKqf/7GDjth6ksuS/6p7R49V4CBY6/E7R/iyhYUA= +github.com/libp2p/go-yamux v1.2.2/go.mod h1:FGTiPvoV/3DVdgWpX+tM0OW3tsM+W5bSE3gZwqQTcow= +github.com/libp2p/go-yamux v1.3.0/go.mod h1:FGTiPvoV/3DVdgWpX+tM0OW3tsM+W5bSE3gZwqQTcow= +github.com/libp2p/go-yamux v1.3.3/go.mod h1:FGTiPvoV/3DVdgWpX+tM0OW3tsM+W5bSE3gZwqQTcow= +github.com/libp2p/go-yamux v1.3.5/go.mod h1:FGTiPvoV/3DVdgWpX+tM0OW3tsM+W5bSE3gZwqQTcow= +github.com/libp2p/go-yamux v1.3.7/go.mod h1:fr7aVgmdNGJK+N1g+b6DW6VxzbRCjCOejR/hkmpooHE= +github.com/libp2p/go-yamux v1.4.0/go.mod h1:fr7aVgmdNGJK+N1g+b6DW6VxzbRCjCOejR/hkmpooHE= +github.com/libp2p/go-yamux v1.4.1/go.mod h1:fr7aVgmdNGJK+N1g+b6DW6VxzbRCjCOejR/hkmpooHE= +github.com/libp2p/go-yamux/v2 v2.0.0/go.mod h1:NVWira5+sVUIU6tu1JWvaRn1dRnG+cawOJiflsAM+7U= +github.com/libp2p/go-yamux/v2 v2.1.1/go.mod h1:3So6P6TV6r75R9jiBpiIKgU/66lOarCZjqROGxzPpPQ= +github.com/lucas-clemente/quic-go v0.19.3/go.mod h1:ADXpNbTQjq1hIzCpB+y/k5iz4n4z4IwqoLb94Kh5Hu8= +github.com/lunixbochs/vtclean v1.0.0/go.mod h1:pHhQNgMf3btfWnGBVipUOjRYhoOsdGqdm/+2c2E2WMI= +github.com/magiconair/properties v1.8.0/go.mod h1:PppfXfuXeibc/6YijjN8zIbojt8czPbwD3XqdrwzmxQ= +github.com/mailru/easyjson v0.0.0-20180823135443-60711f1a8329/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc= +github.com/mailru/easyjson v0.0.0-20190312143242-1de009706dbe/go.mod h1:C1wdFJiN94OJF2b5HbByQZoLdCWB1Yqtg26g4irojpc= +github.com/marten-seemann/qpack v0.2.1/go.mod h1:F7Gl5L1jIgN1D11ucXefiuJS9UMVP2opoCp2jDKb7wc= +github.com/marten-seemann/qtls v0.10.0/go.mod h1:UvMd1oaYDACI99/oZUYLzMCkBXQVT0aGm99sJhbT8hs= +github.com/marten-seemann/qtls-go1-15 v0.1.1/go.mod h1:GyFwywLKkRt+6mfU99csTEY1joMZz5vmB1WNZH3P81I= +github.com/mattn/go-colorable v0.0.9/go.mod h1:9vuHe8Xs5qXnSaW/c/ABM9alt+Vo+STaOChaDxuIBZU= +github.com/mattn/go-colorable v0.1.1/go.mod h1:FuOcm+DKB9mbwrcAfNl7/TZVBZ6rcnceauSikq3lYCQ= +github.com/mattn/go-isatty v0.0.4/go.mod h1:M+lRXTBqGeGNdLjl/ufCoiOlB5xdOkqRJdNxMWT7Zi4= +github.com/mattn/go-isatty v0.0.5/go.mod h1:Iq45c/XA43vh69/j3iqttzPXn0bhXyGjM0Hdxcsrc5s= +github.com/matttproud/golang_protobuf_extensions v1.0.1/go.mod h1:D8He9yQNgCq6Z5Ld7szi9bcBfOoFv/3dc6xSMkL2PC0= +github.com/mgutz/ansi v0.0.0-20170206155736-9520e82c474b/go.mod h1:01TrycV0kFyexm33Z7vhZRXopbI8J3TDReVlkTgMUxE= +github.com/microcosm-cc/bluemonday v1.0.1/go.mod h1:hsXNsILzKxV+sX77C5b8FSuKF00vh2OMYv+xgHpAMF4= +github.com/miekg/dns v1.1.12/go.mod h1:W1PPwlIAgtquWBMBEV9nkV9Cazfe8ScdGz/Lj7v3Nrg= +github.com/miekg/dns v1.1.28/go.mod h1:KNUDUusw/aVsxyTYZM1oqvCicbwhgbNgztCETuNZ7xM= +github.com/miekg/dns v1.1.31/go.mod h1:KNUDUusw/aVsxyTYZM1oqvCicbwhgbNgztCETuNZ7xM= +github.com/miekg/dns v1.1.41/go.mod h1:p6aan82bvRIyn+zDIv9xYNUpwa73JcSh9BKwknJysuI= +github.com/minio/blake2b-simd v0.0.0-20160723061019-3f5f724cb5b1 h1:lYpkrQH5ajf0OXOcUbGjvZxxijuBwbbmlSxLiuofa+g= +github.com/minio/blake2b-simd v0.0.0-20160723061019-3f5f724cb5b1/go.mod h1:pD8RvIylQ358TN4wwqatJ8rNavkEINozVn9DtGI3dfQ= +github.com/minio/sha256-simd v0.0.0-20190131020904-2d45a736cd16/go.mod h1:2FMWW+8GMoPweT6+pI63m9YE3Lmw4J71hV56Chs1E/U= +github.com/minio/sha256-simd v0.0.0-20190328051042-05b4dd3047e5/go.mod h1:2FMWW+8GMoPweT6+pI63m9YE3Lmw4J71hV56Chs1E/U= +github.com/minio/sha256-simd v0.1.0/go.mod h1:2FMWW+8GMoPweT6+pI63m9YE3Lmw4J71hV56Chs1E/U= +github.com/minio/sha256-simd v0.1.1-0.20190913151208-6de447530771/go.mod h1:B5e1o+1/KgNmWrSQK08Y6Z1Vb5pwIktudl0J58iy0KM= +github.com/minio/sha256-simd v0.1.1/go.mod h1:B5e1o+1/KgNmWrSQK08Y6Z1Vb5pwIktudl0J58iy0KM= +github.com/minio/sha256-simd v1.0.0 h1:v1ta+49hkWZyvaKwrQB8elexRqm6Y0aMLjCNsrYxo6g= +github.com/minio/sha256-simd v1.0.0/go.mod h1:OuYzVNI5vcoYIAmbIvHPl3N3jUzVedXbKy5RFepssQM= +github.com/mitchellh/go-homedir v1.1.0/go.mod h1:SfyaCUpYCn1Vlf4IUYiD9fPX4A5wJrkLzIz1N1q0pr0= +github.com/mitchellh/mapstructure v1.1.2/go.mod h1:FVVH3fgwuzCH5S8UJGiWEs2h04kUh9fWfEaFds41c1Y= +github.com/modern-go/concurrent v0.0.0-20180306012644-bacd9c7ef1dd/go.mod h1:6dJC0mAP4ikYIbvyc7fijjWJddQyLn8Ig3JB5CqoB9Q= +github.com/modern-go/reflect2 v1.0.1/go.mod h1:bx2lNnkwVCuqBIxFjflWJWanXIb3RllmbCylyMrvgv0= +github.com/mr-tron/base58 v1.1.0/go.mod h1:xcD2VGqlgYjBdcBLw+TuYLr8afG+Hj8g2eTVqeSzSU8= +github.com/mr-tron/base58 v1.1.1/go.mod h1:xcD2VGqlgYjBdcBLw+TuYLr8afG+Hj8g2eTVqeSzSU8= +github.com/mr-tron/base58 v1.1.2/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/mr-tron/base58 v1.1.3/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/mr-tron/base58 v1.2.0 h1:T/HDJBh4ZCPbU39/+c3rRvE0uKBQlU27+QI8LJ4t64o= +github.com/mr-tron/base58 v1.2.0/go.mod h1:BinMc/sQntlIE1frQmRFPUoPA1Zkr8VRgBdjWI2mNwc= +github.com/multiformats/go-base32 v0.0.3 h1:tw5+NhuwaOjJCC5Pp82QuXbrmLzWg7uxlMFp8Nq/kkI= +github.com/multiformats/go-base32 v0.0.3/go.mod h1:pLiuGC8y0QR3Ue4Zug5UzK9LjgbkL8NSQj0zQ5Nz/AA= +github.com/multiformats/go-base36 v0.1.0 h1:JR6TyF7JjGd3m6FbLU2cOxhC0Li8z8dLNGQ89tUg4F4= +github.com/multiformats/go-base36 v0.1.0/go.mod h1:kFGE83c6s80PklsHO9sRn2NCoffoRdUUOENyW/Vv6sM= +github.com/multiformats/go-multiaddr v0.0.1/go.mod h1:xKVEak1K9cS1VdmPZW3LSIb6lgmoS58qz/pzqmAxV44= +github.com/multiformats/go-multiaddr v0.0.2/go.mod h1:xKVEak1K9cS1VdmPZW3LSIb6lgmoS58qz/pzqmAxV44= +github.com/multiformats/go-multiaddr v0.0.4/go.mod h1:xKVEak1K9cS1VdmPZW3LSIb6lgmoS58qz/pzqmAxV44= +github.com/multiformats/go-multiaddr v0.1.0/go.mod h1:xKVEak1K9cS1VdmPZW3LSIb6lgmoS58qz/pzqmAxV44= +github.com/multiformats/go-multiaddr v0.1.1/go.mod h1:aMKBKNEYmzmDmxfX88/vz+J5IU55txyt0p4aiWVohjo= +github.com/multiformats/go-multiaddr v0.2.0/go.mod h1:0nO36NvPpyV4QzvTLi/lafl2y95ncPj0vFwVF6k6wJ4= +github.com/multiformats/go-multiaddr v0.2.1/go.mod h1:s/Apk6IyxfvMjDafnhJgJ3/46z7tZ04iMk5wP4QMGGE= +github.com/multiformats/go-multiaddr v0.2.2/go.mod h1:NtfXiOtHvghW9KojvtySjH5y0u0xW5UouOmQQrn6a3Y= +github.com/multiformats/go-multiaddr v0.3.0/go.mod h1:dF9kph9wfJ+3VLAaeBqo9Of8x4fJxp6ggJGteB8HQTI= +github.com/multiformats/go-multiaddr v0.3.1/go.mod h1:uPbspcUPd5AfaP6ql3ujFY+QWzmBD8uLLL4bXW0XfGc= +github.com/multiformats/go-multiaddr-dns v0.0.1/go.mod h1:9kWcqw/Pj6FwxAwW38n/9403szc57zJPs45fmnznu3Q= +github.com/multiformats/go-multiaddr-dns v0.0.2/go.mod h1:9kWcqw/Pj6FwxAwW38n/9403szc57zJPs45fmnznu3Q= +github.com/multiformats/go-multiaddr-dns v0.2.0/go.mod h1:TJ5pr5bBO7Y1B18djPuRsVkduhQH2YqYSbxWJzYGdK0= +github.com/multiformats/go-multiaddr-dns v0.3.1/go.mod h1:G/245BRQ6FJGmryJCrOuTdB37AMA5AMOVuO6NY3JwTk= +github.com/multiformats/go-multiaddr-fmt v0.0.1/go.mod h1:aBYjqL4T/7j4Qx+R73XSv/8JsgnRFlf0w2KGLCmXl3Q= +github.com/multiformats/go-multiaddr-fmt v0.1.0/go.mod h1:hGtDIW4PU4BqJ50gW2quDuPVjyWNZxToGUh/HwTZYJo= +github.com/multiformats/go-multiaddr-net v0.0.1/go.mod h1:nw6HSxNmCIQH27XPGBuX+d1tnvM7ihcFwHMSstNAVUU= +github.com/multiformats/go-multiaddr-net v0.1.0/go.mod h1:5JNbcfBOP4dnhoZOv10JJVkJO0pCCEf8mTnipAo2UZQ= +github.com/multiformats/go-multiaddr-net v0.1.1/go.mod h1:5JNbcfBOP4dnhoZOv10JJVkJO0pCCEf8mTnipAo2UZQ= +github.com/multiformats/go-multiaddr-net v0.1.2/go.mod h1:QsWt3XK/3hwvNxZJp92iMQKME1qHfpYmyIjFVsSOY6Y= +github.com/multiformats/go-multiaddr-net v0.1.3/go.mod h1:ilNnaM9HbmVFqsb/qcNysjCu4PVONlrBZpHIrw/qQuA= +github.com/multiformats/go-multiaddr-net v0.1.4/go.mod h1:ilNnaM9HbmVFqsb/qcNysjCu4PVONlrBZpHIrw/qQuA= +github.com/multiformats/go-multiaddr-net v0.1.5/go.mod h1:ilNnaM9HbmVFqsb/qcNysjCu4PVONlrBZpHIrw/qQuA= +github.com/multiformats/go-multiaddr-net v0.2.0/go.mod h1:gGdH3UXny6U3cKKYCvpXI5rnK7YaOIEOPVDI9tsJbEA= +github.com/multiformats/go-multibase v0.0.1/go.mod h1:bja2MqRZ3ggyXtZSEDKpl0uO/gviWFaSteVbWT51qgs= +github.com/multiformats/go-multibase v0.0.3 h1:l/B6bJDQjvQ5G52jw4QGSYeOTZoAwIO77RblWplfIqk= +github.com/multiformats/go-multibase v0.0.3/go.mod h1:5+1R4eQrT3PkYZ24C3W2Ue2tPwIdYQD509ZjSb5y9Oc= +github.com/multiformats/go-multihash v0.0.1/go.mod h1:w/5tugSrLEbWqlcgJabL3oHFKTwfvkofsjW2Qa1ct4U= +github.com/multiformats/go-multihash v0.0.5/go.mod h1:lt/HCbqlQwlPBz7lv0sQCdtfcMtlJvakRUn/0Ual8po= +github.com/multiformats/go-multihash v0.0.8/go.mod h1:YSLudS+Pi8NHE7o6tb3D8vrpKa63epEDmG8nTduyAew= +github.com/multiformats/go-multihash v0.0.10/go.mod h1:YSLudS+Pi8NHE7o6tb3D8vrpKa63epEDmG8nTduyAew= +github.com/multiformats/go-multihash v0.0.13/go.mod h1:VdAWLKTwram9oKAatUcLxBNUjdtcVwxObEQBtRfuyjc= +github.com/multiformats/go-multihash v0.0.14/go.mod h1:VdAWLKTwram9oKAatUcLxBNUjdtcVwxObEQBtRfuyjc= +github.com/multiformats/go-multihash v0.0.15 h1:hWOPdrNqDjwHDx82vsYGSDZNyktOJJ2dzZJzFkOV1jM= +github.com/multiformats/go-multihash v0.0.15/go.mod h1:D6aZrWNLFTV/ynMpKsNtB40mJzmCl4jb1alC0OvHiHg= +github.com/multiformats/go-multistream v0.1.0/go.mod h1:fJTiDfXJVmItycydCnNx4+wSzZ5NwG2FEVAI30fiovg= +github.com/multiformats/go-multistream v0.1.1/go.mod h1:KmHZ40hzVxiaiwlj3MEbYgK9JFk2/9UktWZAF54Du38= +github.com/multiformats/go-multistream v0.2.0/go.mod h1:5GZPQZbkWOLOn3J2y4Y99vVW7vOfsAflxARk3x14o6k= +github.com/multiformats/go-multistream v0.2.1/go.mod h1:5GZPQZbkWOLOn3J2y4Y99vVW7vOfsAflxARk3x14o6k= +github.com/multiformats/go-multistream v0.2.2/go.mod h1:UIcnm7Zuo8HKG+HkWgfQsGL+/MIEhyTqbODbIUwSXKs= +github.com/multiformats/go-varint v0.0.1/go.mod h1:3Ls8CIEsrijN6+B7PbrXRPxHRPuXSrVKRY101jdMZYE= +github.com/multiformats/go-varint v0.0.2/go.mod h1:3Ls8CIEsrijN6+B7PbrXRPxHRPuXSrVKRY101jdMZYE= +github.com/multiformats/go-varint v0.0.5/go.mod h1:3Ls8CIEsrijN6+B7PbrXRPxHRPuXSrVKRY101jdMZYE= +github.com/multiformats/go-varint v0.0.6 h1:gk85QWKxh3TazbLxED/NlDVv8+q+ReFJk7Y2W/KhfNY= +github.com/multiformats/go-varint v0.0.6/go.mod h1:3Ls8CIEsrijN6+B7PbrXRPxHRPuXSrVKRY101jdMZYE= +github.com/neelance/astrewrite v0.0.0-20160511093645-99348263ae86/go.mod h1:kHJEU3ofeGjhHklVoIGuVj85JJwZ6kWPaJwCIxgnFmo= +github.com/neelance/sourcemap v0.0.0-20151028013722-8c68805598ab/go.mod h1:Qr6/a/Q4r9LP1IltGz7tA7iOK1WonHEYhu1HRBA7ZiM= +github.com/nxadm/tail v1.4.4/go.mod h1:kenIhsEOeOJmVchQTgglprH7qJGnHDVpk1VPCcaMI8A= +github.com/onsi/ginkgo v1.6.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= +github.com/onsi/ginkgo v1.7.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= +github.com/onsi/ginkgo v1.8.0/go.mod h1:lLunBs/Ym6LB5Z9jYTR76FiuTmxDTDusOGeTQH+WWjE= +github.com/onsi/ginkgo v1.12.0/go.mod h1:oUhWkIvk5aDxtKvDDuw8gItl8pKl42LzjC9KZE0HfGg= +github.com/onsi/ginkgo v1.12.1/go.mod h1:zj2OWP4+oCPe1qIXoGWkgMRwljMUYCdkwsT2108oapk= +github.com/onsi/ginkgo v1.14.0/go.mod h1:iSB4RoI2tjJc9BBv4NKIKWKya62Rps+oPG/Lv9klQyY= +github.com/onsi/gomega v1.4.1/go.mod h1:C1qb7wdrVGGVU+Z6iS04AVkA3Q65CEZX59MT0QO5uiA= +github.com/onsi/gomega v1.4.3/go.mod h1:ex+gbHU/CVuBBDIJjb2X0qEXbFg53c61hWP/1CpauHY= +github.com/onsi/gomega v1.5.0/go.mod h1:ex+gbHU/CVuBBDIJjb2X0qEXbFg53c61hWP/1CpauHY= +github.com/onsi/gomega v1.7.1/go.mod h1:XdKZgCCFLUoM/7CFJVPcG8C1xQ1AJ0vpAezJrB7JYyY= +github.com/onsi/gomega v1.9.0/go.mod h1:Ho0h+IUsWyvy1OpqCwxlQ/21gkhVunqlU8fDGcoTdcA= +github.com/onsi/gomega v1.10.1/go.mod h1:iN09h71vgCQne3DLsj+A5owkum+a2tYe+TOCB1ybHNo= +github.com/opentracing/opentracing-go v1.0.2/go.mod h1:UkNAQd3GIcIGf0SeVgPpRdFStlNbqXla1AfSYxPUl2o= +github.com/opentracing/opentracing-go v1.1.0/go.mod h1:UkNAQd3GIcIGf0SeVgPpRdFStlNbqXla1AfSYxPUl2o= +github.com/opentracing/opentracing-go v1.2.0 h1:uEJPy/1a5RIPAJ0Ov+OIO8OxWu77jEv+1B0VhjKrZUs= +github.com/opentracing/opentracing-go v1.2.0/go.mod h1:GxEUsuufX4nBwe+T+Wl9TAgYrxe9dPLANfrWvHYVTgc= +github.com/openzipkin/zipkin-go v0.1.1/go.mod h1:NtoC/o8u3JlF1lSlyPNswIbeQH9bJTmOf0Erfk+hxe8= +github.com/pelletier/go-toml v1.2.0/go.mod h1:5z9KED0ma1S8pY6P1sdut58dfprrGBbd/94hg7ilaic= +github.com/pkg/errors v0.8.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= +github.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4= +github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0= +github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM= +github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4= +github.com/prometheus/client_golang v0.8.0/go.mod h1:7SWBe2y4D6OKWSNQJUaRYU/AaXPKyh/dDVn+NZz0KFw= +github.com/prometheus/client_model v0.0.0-20180712105110-5c3871d89910/go.mod h1:MbSGuTsp3dbXC40dX6PRTWyKYBIrTGTE9sqQNg2J8bo= +github.com/prometheus/client_model v0.0.0-20190812154241-14fe0d1b01d4/go.mod h1:xMI15A0UPsDsEKsMN9yxemIoYk6Tm2C1GtYGdfGttqA= +github.com/prometheus/common v0.0.0-20180801064454-c7de2306084e/go.mod h1:daVV7qP5qjZbuso7PdcryaAu0sAZbrN9i7WWcTMWvro= +github.com/prometheus/procfs v0.0.0-20180725123919-05ee40e3a273/go.mod h1:c3At6R/oaqEKCNdg8wHV1ftS6bRYblBhIjjI8uT2IGk= +github.com/rogpeppe/go-internal v1.3.0/go.mod h1:M8bDsm7K2OlrFYOpmOWEs/qY81heoFRclV5y23lUDJ4= +github.com/russross/blackfriday v1.5.2/go.mod h1:JO/DiYxRf+HjHt06OyowR9PTA263kcR/rfWxYHBV53g= +github.com/sergi/go-diff v1.0.0/go.mod h1:0CfEIISq7TuYL3j771MWULgwwjU+GofnZX9QAmXWZgo= +github.com/shurcooL/component v0.0.0-20170202220835-f88ec8f54cc4/go.mod h1:XhFIlyj5a1fBNx5aJTbKoIq0mNaPvOagO+HjB3EtxrY= +github.com/shurcooL/events v0.0.0-20181021180414-410e4ca65f48/go.mod h1:5u70Mqkb5O5cxEA8nxTsgrgLehJeAw6Oc4Ab1c/P1HM= +github.com/shurcooL/github_flavored_markdown v0.0.0-20181002035957-2122de532470/go.mod h1:2dOwnU2uBioM+SGy2aZoq1f/Sd1l9OkAeAUvjSyvgU0= +github.com/shurcooL/go v0.0.0-20180423040247-9e1955d9fb6e/go.mod h1:TDJrrUr11Vxrven61rcy3hJMUqaf/CLWYhHNPmT14Lk= +github.com/shurcooL/go-goon v0.0.0-20170922171312-37c2f522c041/go.mod h1:N5mDOmsrJOB+vfqUK+7DmDyjhSLIIBnXo9lvZJj3MWQ= +github.com/shurcooL/gofontwoff v0.0.0-20180329035133-29b52fc0a18d/go.mod h1:05UtEgK5zq39gLST6uB0cf3NEHjETfB4Fgr3Gx5R9Vw= +github.com/shurcooL/gopherjslib v0.0.0-20160914041154-feb6d3990c2c/go.mod h1:8d3azKNyqcHP1GaQE/c6dDgjkgSx2BZ4IoEi4F1reUI= +github.com/shurcooL/highlight_diff v0.0.0-20170515013008-09bb4053de1b/go.mod h1:ZpfEhSmds4ytuByIcDnOLkTHGUI6KNqRNPDLHDk+mUU= +github.com/shurcooL/highlight_go v0.0.0-20181028180052-98c3abbbae20/go.mod h1:UDKB5a1T23gOMUJrI+uSuH0VRDStOiUVSjBTRDVBVag= +github.com/shurcooL/home v0.0.0-20181020052607-80b7ffcb30f9/go.mod h1:+rgNQw2P9ARFAs37qieuu7ohDNQ3gds9msbT2yn85sg= +github.com/shurcooL/htmlg v0.0.0-20170918183704-d01228ac9e50/go.mod h1:zPn1wHpTIePGnXSHpsVPWEktKXHr6+SS6x/IKRb7cpw= +github.com/shurcooL/httperror v0.0.0-20170206035902-86b7830d14cc/go.mod h1:aYMfkZ6DWSJPJ6c4Wwz3QtW22G7mf/PEgaB9k/ik5+Y= +github.com/shurcooL/httpfs v0.0.0-20171119174359-809beceb2371/go.mod h1:ZY1cvUeJuFPAdZ/B6v7RHavJWZn2YPVFQ1OSXhCGOkg= +github.com/shurcooL/httpgzip v0.0.0-20180522190206-b1c53ac65af9/go.mod h1:919LwcH0M7/W4fcZ0/jy0qGght1GIhqyS/EgWGH2j5Q= +github.com/shurcooL/issues v0.0.0-20181008053335-6292fdc1e191/go.mod h1:e2qWDig5bLteJ4fwvDAc2NHzqFEthkqn7aOZAOpj+PQ= +github.com/shurcooL/issuesapp v0.0.0-20180602232740-048589ce2241/go.mod h1:NPpHK2TI7iSaM0buivtFUc9offApnI0Alt/K8hcHy0I= +github.com/shurcooL/notifications v0.0.0-20181007000457-627ab5aea122/go.mod h1:b5uSkrEVM1jQUspwbixRBhaIjIzL2xazXp6kntxYle0= +github.com/shurcooL/octicon v0.0.0-20181028054416-fa4f57f9efb2/go.mod h1:eWdoE5JD4R5UVWDucdOPg1g2fqQRq78IQa9zlOV1vpQ= +github.com/shurcooL/reactions v0.0.0-20181006231557-f2e0b4ca5b82/go.mod h1:TCR1lToEk4d2s07G3XGfz2QrgHXg4RJBvjrOozvoWfk= +github.com/shurcooL/sanitized_anchor_name v0.0.0-20170918181015-86672fcb3f95/go.mod h1:1NzhyTcUVG4SuEtjjoZeVRXNmyL/1OwPU0+IJeTBvfc= +github.com/shurcooL/users v0.0.0-20180125191416-49c67e49c537/go.mod h1:QJTqeLYEDaXHZDBsXlPCDqdhQuJkuw4NOtaxYe3xii4= +github.com/shurcooL/webdavfs v0.0.0-20170829043945-18c3829fa133/go.mod h1:hKmq5kWdCj2z2KEozexVbfEZIWiTjhE0+UjmZgPqehw= +github.com/sirupsen/logrus v1.2.0/go.mod h1:LxeOpSwHxABJmUn/MG1IvRgCAasNZTLOkJPxbbu5VWo= +github.com/smola/gocompat v0.2.0/go.mod h1:1B0MlxbmoZNo3h8guHp8HztB3BSYR5itql9qtVc0ypY= +github.com/sourcegraph/annotate v0.0.0-20160123013949-f4cad6c6324d/go.mod h1:UdhH50NIW0fCiwBSr0co2m7BnFLdv4fQTgdqdJTHFeE= +github.com/sourcegraph/syntaxhighlight v0.0.0-20170531221838-bd320f5d308e/go.mod h1:HuIsMU8RRBOtsCgI77wP899iHVBQpCmg4ErYMZB+2IA= +github.com/spacemonkeygo/openssl v0.0.0-20181017203307-c2dcc5cca94a/go.mod h1:7AyxJNCJ7SBZ1MfVQCWD6Uqo2oubI2Eq2y2eqf+A5r0= +github.com/spacemonkeygo/spacelog v0.0.0-20180420211403-2296661a0572/go.mod h1:w0SWMsp6j9O/dk4/ZpIhL+3CkG8ofA2vuv7k+ltqUMc= +github.com/spaolacci/murmur3 v0.0.0-20180118202830-f09979ecbc72/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2Kzu9HwQUA= +github.com/spaolacci/murmur3 v1.1.0/go.mod h1:JwIasOWyU6f++ZhiEuf87xNszmSA2myDM2Kzu9HwQUA= +github.com/spf13/afero v1.1.2/go.mod h1:j4pytiNVoe2o6bmDsKpLACNPDBIoEAkihy7loJ1B0CQ= +github.com/spf13/cast v1.3.0/go.mod h1:Qx5cxh0v+4UWYiBimWS+eyWzqEqokIECu5etghLkUJE= +github.com/spf13/cobra v0.0.5/go.mod h1:3K3wKZymM7VvHMDS9+Akkh4K60UwM26emMESw8tLCHU= +github.com/spf13/jwalterweatherman v1.0.0/go.mod h1:cQK4TGJAtQXfYWX+Ddv3mKDzgVb68N+wFjFa4jdeBTo= +github.com/spf13/pflag v1.0.3/go.mod h1:DYY7MBk1bdzusC3SYhjObp+wFpr4gzcvqqNjLnInEg4= +github.com/spf13/viper v1.3.2/go.mod h1:ZiWeW+zYFKm7srdB9IoDzzZXaJaI5eL9QjNiN/DMA2s= +github.com/src-d/envconfig v1.0.0/go.mod h1:Q9YQZ7BKITldTBnoxsE5gOeB5y66RyPXeue/R4aaNBc= +github.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/objx v0.1.1/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME= +github.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs= +github.com/stretchr/testify v1.3.0/go.mod h1:M5WIy9Dh21IEIfnGCwXGc5bZfKNJtfHm1UVUgZn+9EI= +github.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4= +github.com/stretchr/testify v1.5.1/go.mod h1:5W2xD1RspED5o8YsWQXVCued0rvSQ+mT+I5cxcmMvtA= +github.com/stretchr/testify v1.6.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/stretchr/testify v1.7.0 h1:nwc3DEeHmmLAfoZucVR881uASk0Mfjw8xYJ99tb5CcY= +github.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg= +github.com/syndtr/goleveldb v1.0.0/go.mod h1:ZVVdQEZoIme9iO1Ch2Jdy24qqXrMMOU6lpPAyBWyWuQ= +github.com/tarm/serial v0.0.0-20180830185346-98f6abe2eb07/go.mod h1:kDXzergiv9cbyO7IOYJZWg1U88JhDg3PB6klq9Hg2pA= +github.com/ugorji/go/codec v0.0.0-20181204163529-d75b2dcb6bc8/go.mod h1:VFNgLljTbGfSG7qAOspJ7OScBnGdDN/yBr0sguwnwf0= +github.com/viant/assertly v0.4.8/go.mod h1:aGifi++jvCrUaklKEKT0BU95igDNaqkvz+49uaYMPRU= +github.com/viant/toolbox v0.24.0/go.mod h1:OxMCG57V0PXuIP2HNQrtJf2CjqdmbrOx5EkMILuUhzM= +github.com/whyrusleeping/go-keyspace v0.0.0-20160322163242-5b898ac5add1/go.mod h1:8UvriyWtv5Q5EOgjHaSseUEdkQfvwFv1I/In/O2M9gc= +github.com/whyrusleeping/go-logging v0.0.0-20170515211332-0457bb6b88fc/go.mod h1:bopw91TMyo8J3tvftk8xmU2kPmlrt4nScJQZU2hE5EM= +github.com/whyrusleeping/go-logging v0.0.1/go.mod h1:lDPYj54zutzG1XYfHAhcc7oNXEburHQBn+Iqd4yS4vE= +github.com/whyrusleeping/mafmt v1.2.8/go.mod h1:faQJFPbLSxzD9xpA02ttW/tS9vZykNvXwGvqIpk20FA= +github.com/whyrusleeping/mdns v0.0.0-20190826153040-b9b60ed33aa9/go.mod h1:j4l84WPFclQPj320J9gp0XwNKBb3U0zt5CBqjPp22G4= +github.com/whyrusleeping/multiaddr-filter v0.0.0-20160516205228-e903e4adabd7/go.mod h1:X2c0RVCI1eSUFI8eLcY3c0423ykwiUdxLJtkDvruhjI= +github.com/x-cray/logrus-prefixed-formatter v0.5.2/go.mod h1:2duySbKsL6M18s5GU7VPsoEPHyzalCE06qoARUCeBBE= +github.com/xordataexchange/crypt v0.0.3-0.20170626215501-b2862e3d0a77/go.mod h1:aYKd//L2LvnjZzWKhF00oedf4jCCReLcmhLdhm1A27Q= +github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= +github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74= +go.opencensus.io v0.18.0/go.mod h1:vKdFvxhtzZ9onBp9VKHK8z/sRpBMnKAsufL7wlDrCOA= +go.opencensus.io v0.21.0/go.mod h1:mSImk1erAIZhrmZN+AvHh14ztQfjbGwt4TtuofqLduU= +go.opencensus.io v0.22.1/go.mod h1:Ap50jQcDJrx6rB6VgeeFPtuPIf3wMRvRfrfYDO6+BmA= +go.opencensus.io v0.22.2/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= +go.opencensus.io v0.22.3/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= +go.opencensus.io v0.22.4/go.mod h1:yxeiOL68Rb0Xd1ddK5vPZ/oVn4vY4Ynel7k9FzqtOIw= +go.opencensus.io v0.23.0/go.mod h1:XItmlyltB5F7CS4xOC1DcqMoFqwtC6OG2xF7mCv7P7E= +go.uber.org/atomic v1.4.0/go.mod h1:gD2HeocX3+yG+ygLZcrzQJaqmWj9AIm7n08wl/qW/PE= +go.uber.org/atomic v1.6.0/go.mod h1:sABNBOSYdrvTF6hTgEIbc7YasKWGhgEQZyfxyTvoXHQ= +go.uber.org/atomic v1.7.0 h1:ADUqmZGgLDDfbSL9ZmPxKTybcoEYHgpYfELNoN+7hsw= +go.uber.org/atomic v1.7.0/go.mod h1:fEN4uk6kAWBTFdckzkM89CLk9XfWZrxpCo0nPH17wJc= +go.uber.org/goleak v1.0.0/go.mod h1:8a7PlsEVH3e/a/GLqe5IIrQx6GzcnRmZEufDUTk4A7A= +go.uber.org/multierr v1.1.0/go.mod h1:wR5kodmAFQ0UK8QlbwjlSNy0Z68gJhDJUG5sjR94q/0= +go.uber.org/multierr v1.5.0/go.mod h1:FeouvMocqHpRaaGuG9EjoKcStLC43Zu/fmqdUMPcKYU= +go.uber.org/multierr v1.6.0/go.mod h1:cdWPpRnG4AhwMwsgIHip0KRBQjJy5kYEpYjJxpXp9iU= +go.uber.org/multierr v1.7.0 h1:zaiO/rmgFjbmCXdSYJWQcdvOCsthmdaHfr3Gm2Kx4Ec= +go.uber.org/multierr v1.7.0/go.mod h1:7EAYxJLBy9rStEaz58O2t4Uvip6FSURkq8/ppBp95ak= +go.uber.org/tools v0.0.0-20190618225709-2cfd321de3ee/go.mod h1:vJERXedbb3MVM5f9Ejo0C68/HhF8uaILCdgjnY+goOA= +go.uber.org/zap v1.10.0/go.mod h1:vwi/ZaCAaUcBkycHslxD9B2zi4UTXhF60s6SWpuDF0Q= +go.uber.org/zap v1.14.1/go.mod h1:Mb2vm2krFEG5DV0W9qcHBYFtp/Wku1cvYaqPsS/WYfc= +go.uber.org/zap v1.15.0/go.mod h1:Mb2vm2krFEG5DV0W9qcHBYFtp/Wku1cvYaqPsS/WYfc= +go.uber.org/zap v1.16.0 h1:uFRZXykJGK9lLY4HtgSw44DnIcAM+kRBP7x5m+NpAOM= +go.uber.org/zap v1.16.0/go.mod h1:MA8QOfq0BHJwdXa996Y4dYkAqRKB8/1K1QMMZVaNZjQ= +go4.org v0.0.0-20180809161055-417644f6feb5/go.mod h1:MkTOUMDaeVYJUOUsaDXIhWPZYa1yOyC1qaOBpL57BhE= +golang.org/x/build v0.0.0-20190111050920-041ab4dc3f9d/go.mod h1:OWs+y06UdEOHN4y+MfF/py+xQ/tYqIWW03b70/CG9Rw= +golang.org/x/crypto v0.0.0-20170930174604-9419663f5a44/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20180904163835-0709b304e793/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20181030102418-4d3f4d9ffa16/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20181203042331-505ab145d0a9/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190211182817-74369b46fc67/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190225124518-7f87c0fbb88b/go.mod h1:6SG95UA2DQfeDnfUPMdvaQW0Q7yPrPDi9nlGo2tz2b4= +golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20190313024323-a1f597ede03a/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w= +golang.org/x/crypto v0.0.0-20190426145343-a29dc8fdc734/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20190510104115-cbcb75029529/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20190513172903-22d7a77e9e5f/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20190611184440-5c40567a22f8/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20190618222545-ea8f1a30c443/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI= +golang.org/x/crypto v0.0.0-20200115085410-6d4e4cb37c7d/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200221231518-2aa609cf4a9d/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200423211502-4bdfaf469ed5/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200510223506-06a226fb4e37/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200602180216-279210d13fed/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20200820211705-5c72a883971a/go.mod h1:LzIPMQfyMNhhGPhUkYOs5KpL4U8rLKemX1yGLhDgUto= +golang.org/x/crypto v0.0.0-20210220033148-5ea612d1eb83/go.mod h1:jdWPYTVW3xRLrWPugEBEK3UY2ZEsg3UU495nc5E+M+I= +golang.org/x/crypto v0.0.0-20210322153248-0c34fe9e7dc2/go.mod h1:T9bdIzuCu7OtxOm1hfPfRQxPLYneinmdGuTeoZ9dtd4= +golang.org/x/crypto v0.0.0-20210506145944-38f3c27a63bf/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8= +golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a h1:kr2P4QFmQr29mSLA43kwrOcgcReGTfbE9N577tCTuBc= +golang.org/x/crypto v0.0.0-20210513164829-c07d793c2f9a/go.mod h1:P+XmwS30IXTQdn5tA2iutPOUgjI07+tq3H3K9MVA1s8= +golang.org/x/exp v0.0.0-20190121172915-509febef88a4/go.mod h1:CJ0aWSM057203Lf6IL+f9T1iT9GByDxfZKAQTCR3kQA= +golang.org/x/lint v0.0.0-20180702182130-06c8688daad7/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= +golang.org/x/lint v0.0.0-20181026193005-c67002cb31c3/go.mod h1:UVdnD1Gm6xHRNCYTkRU2/jEulfH38KcIWyp/GAMgvoE= +golang.org/x/lint v0.0.0-20190227174305-5b3e6a55c961/go.mod h1:wehouNa3lNwaWXcvxsM5YxQ5yQlVC4a0KAMCusXpPoU= +golang.org/x/lint v0.0.0-20190313153728-d0100b6bd8b3/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= +golang.org/x/lint v0.0.0-20190930215403-16217165b5de/go.mod h1:6SW0HCj/g11FgYtHlgUYUwCkIfeOF89ocIRzGO/8vkc= +golang.org/x/lint v0.0.0-20200302205851-738671d3881b h1:Wh+f8QHJXR411sJR8/vRBTZ7YapZaRvUcLFFJhusH0k= +golang.org/x/lint v0.0.0-20200302205851-738671d3881b/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY= +golang.org/x/mod v0.0.0-20190513183733-4bf6d317e70e/go.mod h1:mXi4GBBbnImb6dmsKGUJ2LatrhH/nqhxcFungHvyanc= +golang.org/x/mod v0.1.1-0.20191105210325-c90efee705ee/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg= +golang.org/x/mod v0.2.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= +golang.org/x/mod v0.3.0 h1:RM4zey1++hCTbCVQfnWeKs9/IEsaBLA8vTkd0WVtmH4= +golang.org/x/mod v0.3.0/go.mod h1:s0Qsj1ACt9ePp/hMypM3fl4fZqREWJwdYDEqhRiZZUA= +golang.org/x/net v0.0.0-20180719180050-a680a1efc54d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20180724234803-3673e40ba225/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20180826012351-8a410e7b638d/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20180906233101-161cd47e91fd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20181011144130-49bb7cea24b1/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20181029044818-c44066c5c816/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20181106065722-10aee1819953/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190108225652-1e06a53dbb7e/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190213061140-3a22650c66bd/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190227160552-c95aed5357e7/go.mod h1:mL1N/T3taQHkDXs73rZJwtUhF3w3ftmwwsq0BUmARs4= +golang.org/x/net v0.0.0-20190311183353-d8887717615a/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190313220215-9f648a60d977/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg= +golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20190923162816-aa69164e4478/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20200226121028-0de0cce0169b/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s= +golang.org/x/net v0.0.0-20200520004742-59133d7f0dd7/go.mod h1:qpuaurCH72eLCgpAm/N6yyVIVM9cpaDIP3A8BGJEC5A= +golang.org/x/net v0.0.0-20200707034311-ab3426394381/go.mod h1:/O7V0waA8r7cgGh81Ro3o1hOxt32SMVPicZroKQ2sZA= +golang.org/x/net v0.0.0-20201021035429-f5854403a974/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= +golang.org/x/net v0.0.0-20201110031124-69a78807bb2b/go.mod h1:sp8m0HH+o8qH0wwXwYZr8TS3Oi6o0r6Gce1SSxlDquU= +golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg= +golang.org/x/net v0.0.0-20210423184538-5f58ad60dda6/go.mod h1:OJAsFXCWl8Ukc7SiCT/9KSuxbyM7479/AVlXFRxuMCk= +golang.org/x/oauth2 v0.0.0-20180821212333-d2e6202438be/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= +golang.org/x/oauth2 v0.0.0-20181017192945-9dcd33a902f4/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= +golang.org/x/oauth2 v0.0.0-20181203162652-d668ce993890/go.mod h1:N/0e6XlmueqKjAGxoOufVs8QHGRruUQn6yWY3a++T0U= +golang.org/x/oauth2 v0.0.0-20190226205417-e64efc72b421/go.mod h1:gOpvHmFTYa4IltrdGE7lF6nIHvwfUNPOp7c8zoXwtLw= +golang.org/x/perf v0.0.0-20180704124530-6e6d33e29852/go.mod h1:JLpeXjPJfIyPr5TlbXLkXWLhP8nz10XfvxElABhCtcw= +golang.org/x/sync v0.0.0-20180314180146-1d60e4601c6f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20181108010431-42b317875d0f/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20181221193216-37e7f081c4d4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20190227155943-e225da77a7e6/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20190911185100-cd5d95a43a6e/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20200317015054-43a5402ce75a/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sync v0.0.0-20210220032951-036812b2e83c/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM= +golang.org/x/sys v0.0.0-20180830151530-49385e6e1522/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20180905080454-ebe1bf3edb33/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20180909124046-d0be0721c37e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20181029174526-d69651ed3497/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20181205085412-a5c9d58dba9a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190219092855-153ac476189d/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190222072716-a9d3bda3a223/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190228124157-a34e9553db1e/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY= +golang.org/x/sys v0.0.0-20190316082340-a2f829d7f35f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20190405154228-4b34438f7a67/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20190502145724-3ef323f4f1fd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20190526052359-791d8a0f4d09/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20190626221950-04f50cda93cb/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20190904154756-749cb33beabd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20190924154521-2837fb4f24fe/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20191005200804-aed5e4c7ecf9/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20191120155948-bd437916bb0e/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200202164722-d101bd2416d5/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200223170610-d5e6a3e2c0ae/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200323222414-85ca7c5b95cd/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200519105757-fe76b779f299/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200602225109-6fdc65e7d980/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20200930185726-fdedc70b468f/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210303074136-134d130e1a04/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210309074719-68d13333faf2/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210426080607-c94f62235c83/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs= +golang.org/x/sys v0.0.0-20210514084401-e8d321eab015 h1:hZR0X1kPW+nwyJ9xRxqZk1vx5RUObAPBdKVvXPDUH/E= +golang.org/x/sys v0.0.0-20210514084401-e8d321eab015/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg= +golang.org/x/term v0.0.0-20201117132131-f5c789dd3221/go.mod h1:Nr5EML6q2oocZ2LXRh80K7BxOlk5/8JxuGnuhpl+muw= +golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo= +golang.org/x/text v0.0.0-20170915032832-14c0d48ead0c/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/text v0.3.1-0.20180807135948-17ff2d5776d2/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ= +golang.org/x/text v0.3.2/go.mod h1:bEr9sfX3Q8Zfm5fL9x+3itogRgK3+ptLWKqgva+5dAk= +golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= +golang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ= +golang.org/x/time v0.0.0-20180412165947-fbb02b2291d2/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= +golang.org/x/time v0.0.0-20181108054448-85acf8d2951c/go.mod h1:tRJNPiyCQ0inRvYxbN9jk5I+vvW/OXSQhTDSoE431IQ= +golang.org/x/tools v0.0.0-20180221164845-07fd8470d635/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20180828015842-6cd1fcedba52/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20181030000716-a0a13e073c7b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20181030221726-6c7e314b6563/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20181130052023-1c3d964395ce/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190114222345-bf090417da8b/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ= +golang.org/x/tools v0.0.0-20190226205152-f727befe758c/go.mod h1:9Yl7xja0Znq3iFh3HoIrodX9oNMXvdceNzlUR8zjMvY= +golang.org/x/tools v0.0.0-20190311212946-11955173bddd/go.mod h1:LCzVGOaR6xXOjkQ3onu1FJEFr0SW1gC7cKk1uF8kGRs= +golang.org/x/tools v0.0.0-20190425150028-36563e24a262/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= +golang.org/x/tools v0.0.0-20190524140312-2c0ae7006135/go.mod h1:RgjU9mgBXZiqYHBnxXauZ1Gv1EHHAz9KjViQ78xBX0Q= +golang.org/x/tools v0.0.0-20190621195816-6e04913cbbac/go.mod h1:/rFqwRUd4F7ZHNgwSSTFct+R/Kf4OFW1sUzUTQQTgfc= +golang.org/x/tools v0.0.0-20191029041327-9cc4af7d6b2c/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20191029190741-b9c20aec41a5/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20191108193012-7d206e10da11/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo= +golang.org/x/tools v0.0.0-20191216052735-49a3e744a425/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= +golang.org/x/tools v0.0.0-20200130002326-2f3ba24bd6e7/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28= +golang.org/x/tools v0.0.0-20200619180055-7c47624df98f/go.mod h1:EkVYQZoAsY45+roYkvgYkIh4xh/qjgUK9TdY2XT94GE= +golang.org/x/tools v0.0.0-20210106214847-113979e3529a h1:CB3a9Nez8M13wwlr/E2YtwoU+qYHKfC+JrDa45RXXoQ= +golang.org/x/tools v0.0.0-20210106214847-113979e3529a/go.mod h1:emZCQorbCU4vsT4fOWvOPXz4eW1wZW4PmDk9uLelYpA= +golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1 h1:go1bK/D/BFZV2I8cIQd1NKEZ+0owSTG1fDTci4IqFcE= +golang.org/x/xerrors v0.0.0-20200804184101-5ec99f83aff1/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0= +google.golang.org/api v0.0.0-20180910000450-7ca32eb868bf/go.mod h1:4mhQ8q/RsB7i+udVvVy5NUi08OU8ZlA0gRVgrF7VFY0= +google.golang.org/api v0.0.0-20181030000543-1d582fd0359e/go.mod h1:4mhQ8q/RsB7i+udVvVy5NUi08OU8ZlA0gRVgrF7VFY0= +google.golang.org/api v0.1.0/go.mod h1:UGEZY7KEX120AnNLIHFMKIo4obdJhkp2tPbaPlQx13Y= +google.golang.org/appengine v1.1.0/go.mod h1:EbEs0AVv82hx2wNQdGPgUI5lhzA/G0D9YwlJXL52JkM= +google.golang.org/appengine v1.2.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= +google.golang.org/appengine v1.3.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= +google.golang.org/appengine v1.4.0/go.mod h1:xpcJRLb0r/rnEns0DIKYYv+WjYCduHsrkT7/EB5XEv4= +google.golang.org/genproto v0.0.0-20180817151627-c66870c02cf8/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= +google.golang.org/genproto v0.0.0-20180831171423-11092d34479b/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= +google.golang.org/genproto v0.0.0-20181029155118-b69ba1387ce2/go.mod h1:JiN7NxoALGmiZfu7CAH4rXhgtRTLTxftemlI0sWmxmc= +google.golang.org/genproto v0.0.0-20181202183823-bd91e49a0898/go.mod h1:7Ep/1NZk928CDR8SjdVbjWNpdIf6nzjE3BTgJDr2Atg= +google.golang.org/genproto v0.0.0-20190306203927-b5d61aea6440/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= +google.golang.org/genproto v0.0.0-20190307195333-5fe7a883aa19/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= +google.golang.org/genproto v0.0.0-20190425155659-357c62f0e4bb/go.mod h1:VzzqZJRnGkLBvHegQrXjBqPurQTc5/KpmUdxsrq26oE= +google.golang.org/genproto v0.0.0-20190819201941-24fa4b261c55/go.mod h1:DMBHOl98Agz4BDEuKkezgsaosCRResVns1a3J2ZsMNc= +google.golang.org/genproto v0.0.0-20200526211855-cb27e3aa2013/go.mod h1:NbSheEEYHJ7i3ixzK3sjbqSGDJWnxyFXZblF3eUsNvo= +google.golang.org/grpc v1.14.0/go.mod h1:yo6s7OP7yaDglbqo1J04qKzAhqBH6lvTonzMVmEdcZw= +google.golang.org/grpc v1.16.0/go.mod h1:0JHn/cJsOMiMfNA9+DeHDlAU7KAAB5GDlYFpa9MZMio= +google.golang.org/grpc v1.17.0/go.mod h1:6QZJwpn2B+Zp71q/5VxRsJ6NXXVCE5NRUHRo+f3cWCs= +google.golang.org/grpc v1.19.0/go.mod h1:mqu4LbDTu4XGKhr4mRzUsmM4RtVoemTSY81AxZiDr8c= +google.golang.org/grpc v1.20.1/go.mod h1:10oTOabMzJvdu6/UiuZezV6QK5dSlG84ov/aaiqXj38= +google.golang.org/grpc v1.23.0/go.mod h1:Y5yQAOtifL1yxbo5wqy6BxZv8vAUGQwXBOALyacEbxg= +google.golang.org/grpc v1.25.1/go.mod h1:c3i+UQWmh7LiEpx4sFZnkU36qjEYZ0imhYfXVyQciAY= +google.golang.org/grpc v1.27.0/go.mod h1:qbnxyOmOxrQa7FizSgH+ReBfzJrCY1pSN7KXBS8abTk= +google.golang.org/grpc v1.28.1/go.mod h1:rpkK4SK4GF4Ach/+MFLZUBavHOvF2JJB5uozKKal+60= +google.golang.org/grpc v1.31.1/go.mod h1:N36X2cJ7JwdamYAgDz+s+rVMFjt3numwzf/HckM8pak= +google.golang.org/grpc v1.33.2/go.mod h1:JMHMWHQWaTccqQQlmk3MJZS+GWXOdAesneDmEnv2fbc= +google.golang.org/protobuf v0.0.0-20200109180630-ec00e32a8dfd/go.mod h1:DFci5gLYBciE7Vtevhsrf46CRTquxDuWsQurQQe4oz8= +google.golang.org/protobuf v0.0.0-20200221191635-4d8936d0db64/go.mod h1:kwYJMbMJ01Woi6D6+Kah6886xMZcty6N08ah7+eCXa0= +google.golang.org/protobuf v0.0.0-20200228230310-ab0ca4ff8a60/go.mod h1:cfTl7dwQJ+fmap5saPgwCLgHXTUD7jkjRqWcaiX5VyM= +google.golang.org/protobuf v1.20.1-0.20200309200217-e05f789c0967/go.mod h1:A+miEFZTKqfCUM6K7xSMQL9OKL/b6hQv+e19PK+JZNE= +google.golang.org/protobuf v1.21.0/go.mod h1:47Nbq4nVaFHyn7ilMalzfO3qCViNmqZ2kzikPIcrTAo= +google.golang.org/protobuf v1.22.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= +google.golang.org/protobuf v1.23.0/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= +google.golang.org/protobuf v1.23.1-0.20200526195155-81db48ad09cc/go.mod h1:EGpADcykh3NcUnDUJcl1+ZksZNG86OlYog2l/sGQquU= +google.golang.org/protobuf v1.25.0/go.mod h1:9JNX74DMeImyA3h4bdi1ymwjUzf21/xIlbajtzgsN7c= +gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20180628173108-788fd7840127/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0= +gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk= +gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q= +gopkg.in/errgo.v2 v2.1.0/go.mod h1:hNsd1EY+bozCKY1Ytp96fpM3vjJbqLJn88ws8XvfDNI= +gopkg.in/fsnotify.v1 v1.4.7/go.mod h1:Tz8NjZHkW78fSQdbUxIjBTcgA1z1m8ZHf0WmKUhAMys= +gopkg.in/inf.v0 v0.9.1/go.mod h1:cWUDdTG/fYaXco+Dcufb5Vnc6Gp2YChqWtbxRZE0mXw= +gopkg.in/src-d/go-cli.v0 v0.0.0-20181105080154-d492247bbc0d/go.mod h1:z+K8VcOYVYcSwSjGebuDL6176A1XskgbtNl64NSg+n8= +gopkg.in/src-d/go-log.v1 v1.0.1/go.mod h1:GN34hKP0g305ysm2/hctJ0Y8nWP3zxXXJ8GFabTyABE= +gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7/go.mod h1:dt/ZhP58zS4L8KSrWDmTeBkI65Dw0HsyUHuEVlX15mw= +gopkg.in/yaml.v2 v2.2.1/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v2 v2.2.4/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v2 v2.3.0 h1:clyUAQHOM3G0M3f5vQj7LuJrETvjVot3Z5el9nffUtU= +gopkg.in/yaml.v2 v2.3.0/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI= +gopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +gopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b h1:h8qDotaEPuJATrMmW04NCwg7v22aHH28wwpauUhK9Oo= +gopkg.in/yaml.v3 v3.0.0-20210107192922-496545a6307b/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM= +grpc.go4.org v0.0.0-20170609214715-11d0a25b4919/go.mod h1:77eQGdRu53HpSqPFJFmuJdjuHRquDANNeA4x7B8WQ9o= +honnef.co/go/tools v0.0.0-20180728063816-88497007e858/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= +honnef.co/go/tools v0.0.0-20190102054323-c2f93a96b099/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= +honnef.co/go/tools v0.0.0-20190106161140-3f1c8253044a/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= +honnef.co/go/tools v0.0.0-20190523083050-ea95bdfd59fc/go.mod h1:rf3lG4BRIbNafJWhAfAdb/ePZxsR/4RtNHQocxwk9r4= +honnef.co/go/tools v0.0.1-2019.2.3 h1:3JgtbtFHMiCmsznwGVTUWbgGov+pVqnlf1dEJTNAXeM= +honnef.co/go/tools v0.0.1-2019.2.3/go.mod h1:a3bituU0lyd329TUQxRnasdCoJDkEUEAqEt0JzvZhAg= +rsc.io/quote/v3 v3.1.0/go.mod h1:yEA65RcK8LyAZtP9Kv3t0HmxON59tX3rD+tICJqUlj0= +rsc.io/sampler v1.3.0/go.mod h1:T1hPZKmBbMNahiBKFy5HrXp6adAjACjK9JXDnKaTXpA= +sourcegraph.com/sourcegraph/go-diff v0.5.0/go.mod h1:kuch7UrkMzY0X+p9CRK03kfuPQ2zzQcaEFbx8wA8rck= +sourcegraph.com/sqs/pbtypes v0.0.0-20180604144634-d3ebe8f20ae4/go.mod h1:ketZ/q3QxT9HOBeFhu6RdvsftgpsbFHBF5Cas6cDKZ0= diff --git a/storage/dsadapter/README.md b/storage/dsadapter/README.md index 67570959..1a4cf6ed 100644 --- a/storage/dsadapter/README.md +++ b/storage/dsadapter/README.md @@ -8,6 +8,7 @@ forward into the `go-ipld-prime/storage` interfaces. For example, this can be used to use "flatfs" and other datastore plugins with go-ipld-prime storage APIs. + Why structured like this? ------------------------- @@ -31,3 +32,39 @@ We put this separate module in the same git repo as `go-ipld-prime`... because w Technically, neither this module nor the go-ipld-prime module depend on each other -- they just have interfaces that are aligned with each other -- so it's very easy to hold them as separate go modules in the same repo, even though that can otherwise sometimes be tricky. + + +Which of `dsadapter` vs `bsadapter` vs `bsrvadapter` should I use? +------------------------------------------------------------------ + +None of them, ideally. +A direct implementation of the storage APIs will almost certainly be able to perform better than any of these adapters. + +Failing that: use the adapter matching whatever you've got on hand in your code. + +There is no correct choice. + +dsadapter suffers avoidable excessive allocs in processing its key type, +due to choices in the interior of `github.com/ipfs/go-datastore`. +It is also unable to support streaming operation, should you desire it. + +bsadapter and bsrvadapter both also suffer overhead due to their key type, +because they require a transformation back from the plain binary strings used in the storage API to the concrete go-cid type, +which spends some avoidable CPU time (and also, at present, causes avoidable allocs because of some interesting absenses in `go-cid`). +Additionally, they suffer avoidable allocs because they wrap the raw binary data in a "block" type, +which is an interface, and thus heap-escapes; and we need none of that in the storage APIs, and just return the raw data. +They are also unable to support streaming operation, should you desire it. + +It's best to choose the shortest path and use the adapter to whatever layer you need to get to -- +for example, if you really want to use a `go-datastore` implementation, +*don't* use `bsadapter` and have it wrap a `go-blockstore` that wraps a `go-datastore` if you can help it: +instead, use `dsadapter` and wrap the `go-datastore` without any extra layers of indirection. +You should prefer this because most of the notes above about avoidable allocs are true when +the legacy interfaces are communicating with each other, as well... +so the less you use the internal layering of the legacy interfaces, the better off you'll be. + +Using a direct implementation of the storage APIs will suffer none of these overheads, +and so will always be your best bet if possible. + +If you have to use one of these adapters, hopefully the performance overheads fall within an acceptable margin. +If not: we'll be overjoyed to accept help porting things. diff --git a/storage/dsadapter/dsadapter.go b/storage/dsadapter/dsadapter.go index 666f6263..3f5a8e8b 100644 --- a/storage/dsadapter/dsadapter.go +++ b/storage/dsadapter/dsadapter.go @@ -21,6 +21,9 @@ import ( // The go-datastore.Datastore may internally have other configuration, // such as key sharding functions, etc, and we don't interfere with that here; // such configuration should be handled when creating the go-datastore value. +// +// Contexts given to this system are checked for errors at the beginning of an operation, +// but otherwise have no effect, because the Datastore API doesn't accept context parameters. type Adapter struct { Wrapped datastore.Datastore EscapingFunc func(string) string diff --git a/storage/fsstore/fsstore.go b/storage/fsstore/fsstore.go new file mode 100644 index 00000000..c2e5fe2f --- /dev/null +++ b/storage/fsstore/fsstore.go @@ -0,0 +1,237 @@ +package fsstore + +import ( + "context" + "crypto/rand" + "encoding/base32" + "encoding/hex" + "fmt" + "io" + "os" + "path/filepath" +) + +// Store is implements storage.ReadableStorage and storage.WritableStorage, +// as well as quite a few of the other extended storage feature interfaces, +// backing it with simple filesystem operations. +// +// This implementation uses golang's usual `os` package for IO, +// so it should be highly portable. +// +// Both the sharding and escaping functions are configurable, +// but a typical recommended setup is to use base32 encoding, +// and a sharding function that returns two shards of two characters each. +// The escaping and sharding functions should be chosen with regard to each other -- +// the sharding function is applied to the escaped form. +type Store struct { + basepath string + escapingFunc func(string) string + shardingFunc func(key string, shards *[]string) +} + +func (store *Store) InitDefaults(basepath string) error { + return store.Init( + basepath, + func(raw string) string { + return base32.StdEncoding.WithPadding(base32.NoPadding).EncodeToString([]byte(raw)) + }, + func(key string, shards *[]string) { + l := len(key) + switch { + case l > 6: + *shards = append(*shards, key[l-7:l-4], key[l-4:l-1], key) + case l > 3: + *shards = append(*shards, "000", key[l-4:l-1], key) + default: + *shards = append(*shards, "000", "000", key) + } + }, + ) +} + +func (store *Store) Init( + basepath string, + escapingFunc func(string) string, + shardingFunc func(key string, shards *[]string), +) error { + // Simple args and state check. + if basepath == "" { + return fmt.Errorf("fsstore: invalid setup args: need a path") + } + if store.basepath != "" { + return fmt.Errorf("fsstore: cannot init: is already initialized") + } + store.basepath = basepath + store.escapingFunc = escapingFunc + store.shardingFunc = shardingFunc + + // Make sure basepath is a dir, and make sure the staging and content dirs exist. + if err := CheckAndMakeBasepath(basepath); err != nil { + return err + } + + // That's it for setup on this one. + return nil +} + +// pathForKey applies sharding funcs as well as adds the basepath prefix, +// returning a string ready to use as a filesystem path. +func (store *Store) pathForKey(key string) string { + shards := make([]string, 1, 4) // future work: would be nice if we could reuse this rather than fresh allocating. + shards[0] = store.basepath // not part of the path shard, but will be a param to Join, so, practical to put here. + //shards[1] = storageDir // not part of the path shard, but will be a param to Join, so, practical to put here. + store.shardingFunc(key, &shards) + return filepath.Join(shards...) +} + +// Has implements go-ipld-prime/storage.Storage.Has. +func (store *Store) Has(ctx context.Context, key string) (bool, error) { + _, err := os.Stat(store.pathForKey(key)) + if err == nil { + return true, nil + } + if os.IsNotExist(err) { + return false, nil + } + return false, err +} + +// Put implements go-ipld-prime/storage.WritableStorage.Put. +func (store *Store) Put(ctx context.Context, key string, content []byte) error { + // We can't improve much on what we get by wrapping the stream interface; + // we always end up using a streaming action on the very bottom because that's how file writing works + // (especially since we care about controlling the write flow enough to be able to do the atomic move at the end). + wr, wrCommitter, err := store.PutStream(ctx) + if err != nil { + return err + } + // Write, all at once. + // Note we can ignore the size return, because the contract of io.Writer states "Write must return a non-nil error if it returns n < len(p)". + _, err = wr.Write(content) + if err != nil { + wrCommitter("") + return err + } + // Commit. + return wrCommitter(key) +} + +// PutStream implements go-ipld-prime/storage.StreamingWritableStorage.PutStream. +func (store *Store) PutStream(ctx context.Context) (io.Writer, func(string) error, error) { + for { + if ctx.Err() != nil { + return nil, nil, ctx.Err() + } + // Open a new file in the staging area, with a random name. + var bs [8]byte + rand.Read(bs[:]) + stagepath := filepath.Join(store.basepath, stagingDir, hex.EncodeToString(bs[:])) + f, err := os.OpenFile(stagepath, os.O_CREATE|os.O_EXCL|os.O_WRONLY, 0666) + if os.IsExist(err) { + continue + } + if err != nil { + return nil, nil, fmt.Errorf("fsstore.BeginWrite: could not create a staging file: %w", err) + } + // Okay, got a handle. Return it... and its commit closure. + return f, func(key string) error { + // Close the staging file. + if err := f.Close(); err != nil { + return err + } + if key == "" { + return os.Remove(stagepath) + } + // n.b. there is a lack of fsync here. I am going to choose to believe that a sane filesystem will not let me do a 'move' without flushing somewhere in between. + + // Figure out where we want it to go. + destpath := store.pathForKey(key) + + // Get it there. + return move(stagepath, destpath) + }, nil + } +} + +const stagingDir = ".temp" // same as flatfs uses. + +func CheckAndMakeBasepath(basepath string) error { + // Is this basepath a dir? + // (This is TOCTOU, obviously, but also it's nice to sanity check early and return error quickly because it's probably a setup error.) + if fi, err := os.Stat(basepath); err != nil { + return fmt.Errorf("fsstore: cannot init: basepath must be a directory: %w", err) + } else { + if !fi.IsDir() { + return fmt.Errorf("fsstore: cannot init: basepath must be a directory") + } + } + + // Make sure the staging dir exists. + err := os.Mkdir(filepath.Join(basepath, stagingDir), 0777) + switch { + case err == nil: + // excellent. + case os.IsExist(err): + // sanity check it's a directory already. + fi, err := os.Stat(filepath.Join(basepath, stagingDir)) + if err != nil { + return fmt.Errorf("fsstore: failed to make staging dir: %w", err) + } + if !fi.IsDir() { + return fmt.Errorf("fsstore: staging dir path contains not a dir!") + } + default: + return fmt.Errorf("fsstore: failed to make staging dir: %w", err) + } + + return nil +} + +// move file at stagepath to destpath. +// First, attempt to directly rename to the destination; +// if we get a ENOENT error code, that means the parent didn't exist, and we make that and then retry. +// If making the parent failed: recurse, and use similar logic. +// +// This optimistic approach should have fewer syscall RTTs when most of the parents exist +// than would be taken if we checked that each parent segment exists. +// +// (An alternative approach would be to blindly mkdir the parent segments every time, +// rather than do this backwards stepping. Have not benchmarked these against each other.) +func move(stagepath, destpath string) error { + err := os.Rename(stagepath, destpath) + if os.IsNotExist(err) { + // This probably means parent of destpath doesn't exist yet, so we'll make it. + // It's technically a race condition to assume that this is because destpath has no parents vs that stagepath hasn't been removed out from underneath us, but, alas; kernel ABIs. + // If we did this will all fds, it could be somewhat better. + // (This is certainly possible, at least in linux; but we'd have to import the syscall package and do it ourselves, which is not a rubicon we're willing to cross in this package.) + // In practice, this is probably not going to kerfuffle things. + if err := haveDir(filepath.Dir(destpath)); err != nil { + return err + } + // Now try again. + // (And don't return quite yet; there's one more check to do, because someone might've raced us.) + err = os.Rename(stagepath, destpath) + } + if os.IsExist(err) { + // Oh! Some content is already there? + // We're a write-once (presumed-to-be-)content-addressable blob store -- that means *we keep what already exists*. + // FIXME: no, I wish this is how the Rename function worked, but it is not, actually. + return os.Remove(stagepath) + } + return err +} + +// haveDir tries to make sure a directory exists at pth. +// If this sounds a lot like os.MkdirAll: yes, +// except this function is going to assume if it exists, it's a dir, +// and that saves us some stat syscalls. +func haveDir(pth string) error { + err := os.Mkdir(pth, 0777) + if os.IsNotExist(err) { + if err := haveDir(filepath.Dir(pth)); err != nil { + return err + } + return os.Mkdir(pth, 0777) + } + return err +} diff --git a/storage/tests/benchmarks.go b/storage/tests/benchmarks.go new file mode 100644 index 00000000..00c266a3 --- /dev/null +++ b/storage/tests/benchmarks.go @@ -0,0 +1,59 @@ +package tests + +import ( + "context" + "testing" + + "github.com/ipld/go-ipld-prime/storage" +) + +/* + General note: + It's important to be careful to benchmark the cost *per op* -- + and not mistake b.N for the scale of corpus to work on. + The corpus size should be a parameter that you supply, + and your benchmark table should have a column for them! +*/ + +func BenchPut(b *testing.B, store storage.WritableStorage, gen Gen, scale int) { + b.ReportAllocs() + b.Logf("benchmarking with b.N=%d", b.N) + + // Use a fixed context throughout; it's not really relevant. + ctx := context.Background() + + // Setup phase: create data up to the scale provided. + // Reset the timer afterwards. + b.Logf("prepopulating %d entries into storage...", scale) + for n := 0; n < scale; n++ { + key, content := gen() + err := store.Put(ctx, key, content) + if err != nil { + b.Fatal(err) + } + } + b.Logf("prepopulating %d entries into storage: done.", scale) + b.ResetTimer() + + // Now continue doing puts in the benchmark loop. + // Note that if 'scale' was initially small, and b.N is big, results may be skewed, + // because the last put of the series will actually be working at scale+b.N-1. + for n := 0; n < b.N; n++ { + // Attempt to avoid counting any time spent by the gen func. + // ... except don't, because the overhead of starting and stopping is actually really high compared to a likely gen function; + // in practice, starting and stopping this frequently causes: + // - alloc count to be reported *correctly* (which is nice) + // - but reported ns/op to become erratic, and inflated (not at all nice) + // - and actuall wall-clock run time to increase drastically (~22x!) (not deadly, but certainly unpleasant) + // It may be best to write a synthetic dummy benchmark to see how much the gen function costs, and subtract that from the other results. + //b.StopTimer() + key, content := gen() + //b.StartTimer() + + // Do the put. + err := store.Put(ctx, key, content) + if err != nil { + b.Fatal(err) + } + } +} diff --git a/storage/tests/generators.go b/storage/tests/generators.go new file mode 100644 index 00000000..ce06ef06 --- /dev/null +++ b/storage/tests/generators.go @@ -0,0 +1,26 @@ +package tests + +import ( + "strconv" +) + +// Gen is a func which should generate key-value pairs. +// It's used to configure benchmarks. +// +// How exactly to use this is up to you, but +// a good gen function should probably return a wide variety of keys, +// and some known distribution of key and content sizes. +// If it returns the same key frequently, it should be documented, +// because key collision rates will affect benchmark results. +type Gen func() (key string, content []byte) + +// NewCounterGen returns a Gen func which yields a unique value on each subsequent call, +// which is simply the base-10 string representation of an incrementing integer. +// The content and the key are the same. +func NewCounterGen(start int64) Gen { + return func() (key string, content []byte) { + k := strconv.FormatInt(start, 10) + start++ + return k, []byte(k) + } +} From 4d9e5f28fd4c1288863be7ba4afdf48d1cff9dd8 Mon Sep 17 00:00:00 2001 From: Eric Myhre Date: Sat, 30 Oct 2021 12:29:50 +0200 Subject: [PATCH 02/14] storage: extract readmes about adapters. Mostly deredundantizing, but made a few improvements as well. --- storage/README_adapters.md | 125 ++++++++++++++++++++++++++++++++++ storage/bsadapter/README.md | 37 ++-------- storage/bsrvadapter/README.md | 37 ++-------- storage/dsadapter/README.md | 56 ++------------- 4 files changed, 146 insertions(+), 109 deletions(-) create mode 100644 storage/README_adapters.md diff --git a/storage/README_adapters.md b/storage/README_adapters.md new file mode 100644 index 00000000..7ce07748 --- /dev/null +++ b/storage/README_adapters.md @@ -0,0 +1,125 @@ +Storage Adapters +================ + +The go-ipld-prime storage APIs were introduced in the v0.14.x ranges of go-ipld-prime, +which happened in fall 2021. + +There are many other pieces of code in the IPLD (and even more so, the IPFS) ecosystem +which predate this, and have interfaces that are very _similar_, but not quite exactly the same. + +In order to keep using that code, we've built a series of adapters. + +You can see these in packages beneath this one: + +- `go-ipld-prime/storage/bsadapter` is an adapter to `github.com/ipfs/go-ipfs-blockstore`. +- `go-ipld-prime/storage/dsadapter` is an adapter to `github.com/ipfs/go-datastore`. +- `go-ipld-prime/storage/bsrvadapter` is an adapter to `github.com/ipfs/go-blockservice`. + +Note that there are also other packages which implement the go-ipld-prime storage APIs, +but are not considered "adapters" -- these just implement the storage APIs directly: + +- `go-ipld-prime/storage/memstore` is a simple in-memory storage system. +- `go-ipld-prime/storage/fsstore` is a simple filesystem-backed storage system + (comparable to, and compatible with [flatfs](https://pkg.go.dev/github.com/ipfs/go-ds-flatfs), + if you're familiar with that -- but higher efficiency). + +Finally, note that there are some shared benchmarks across all this: + +- check out `go-ipld-prime/storage/benchmarks`! + + +Why structured like this? +------------------------- + +### Why is there adapter code at all? + +The `go-ipld-prime/storage` interfaces are a newer generation. + +A new generation of APIs was desirable because it unifies the old APIs, +and also because we were able to improves and update several things in the process. +(You can see some of the list of improvements in https://github.com/ipld/go-ipld-prime/pull/265, +where these APIs were first introduced.) +The new generation of APIs avoids several types present in the old APIs which forced otherwise-avoidable allocations. +(See notes later in this document about "which adapter should I use" for more on that.) +Finally, the new generation of APIs is carefully designed to support minimal implementations, +by carefully avoiding use of non-standard-library types in key API definitions, +and by keeping most advanced features behind a standardized convention of feature detection. + +Because the newer generation of APIs are not exactly the same as the multiple older APIs we're unifying and updating, +some amount of adapter code is necessary. + +(Fortunately, it's not much! But it's not "none", either.) + +### Why have this code in a shared place? + +The glue code to connect `go-datastore` and the other older APIs +to the new `go-ipld-prime/storage` APIs is fairly minimal... +but there's also no reason for anyone to write it twice, +so we want to put it somewhere easy to share. + +### Why do the adapters have their own go modules? + +A separate module is used because it's important that go-ipld-prime can be used +without forming a dependency on `go-datastore` (or the other relevant modules, per adapter). + +We want this so that there's a reasonable deprecation pathway -- it must be +possible to write new code that doesn't take on transitive dependencies to old code. + +(As a bonus, looking at the module dependency graphs makes an interestingly +clear statement about why minimal APIs that don't force transitive dependencies are a good idea!) + +### Why is this code all together in this repo? + +We put these separate modules in the same git repo as `go-ipld-prime`... because we can. + +Technically, neither the storage adapter modules nor the `go-ipld-prime` module depend on each other -- +they just have interfaces that are aligned with each other -- so it's very easy to +hold them as separate go modules in the same repo, even though that can otherwise sometimes be tricky. + +You may want to make a point of pulling updated versions of the storage adapters that you use +when pulling updates to go-ipld-prime, though. + +### Could we put these adapters upstream into the other relevant repos? + +Certainly! + +We started with them here because it seemed developmentally lower-friction. +That may change; these APIs could move. +This code is just interface satisfaction, so even having multiple copies of it is utterly harmless. + + +Which of `dsadapter` vs `bsadapter` vs `bsrvadapter` should I use? +------------------------------------------------------------------ + +None of them, ideally. +A direct implementation of the storage APIs will almost certainly be able to perform better than any of these adapters. +(Check out the `fsstore` package, for example.) + +Failing that: use the adapter matching whatever you've got on hand in your code. + +There is no correct choice. + +`dsadapter` suffers avoidable excessive allocs in processing its key type, +due to choices in the interior of `github.com/ipfs/go-datastore`. +It is also unable to support streaming operation, should you desire it. + +`bsadapter` and `bsrvadapter` both also suffer overhead due to their key type, +because they require a transformation back from the plain binary strings used in the storage API to the concrete go-cid type, +which spends some avoidable CPU time (and also, at present, causes avoidable allocs because of some interesting absenses in `go-cid`). +Additionally, they suffer avoidable allocs because they wrap the raw binary data in a "block" type, +which is an interface, and thus heap-escapes; and we need none of that in the storage APIs, and just return the raw data. +They are also unable to support streaming operation, should you desire it. + +It's best to choose the shortest path and use the adapter to whatever layer you need to get to -- +for example, if you really want to use a `go-datastore` implementation, +*don't* use `bsadapter` and have it wrap a `go-blockstore` that wraps a `go-datastore` if you can help it: +instead, use `dsadapter` and wrap the `go-datastore` without any extra layers of indirection. +You should prefer this because most of the notes above about avoidable allocs are true when +the legacy interfaces are communicating with each other, as well... +so the less you use the internal layering of the legacy interfaces, the better off you'll be. + +Using a direct implementation of the storage APIs will suffer none of these overheads, +and so will always be your best bet if possible. + +If you have to use one of these adapters, hopefully the performance overheads fall within an acceptable margin. +If not: we'll be overjoyed to accept help porting things. diff --git a/storage/bsadapter/README.md b/storage/bsadapter/README.md index 201291c9..e9bc951d 100644 --- a/storage/bsadapter/README.md +++ b/storage/bsadapter/README.md @@ -9,40 +9,17 @@ forward into the `go-ipld-prime/storage` interfaces. Why structured like this? ------------------------- -See similar discussion in the `../dsadapter` module. +See `../README_adapters.md` for details about why adapter code is needed, +why this is in a module, why it's here, etc. Which of `dsadapter` vs `bsadapter` vs `bsrvadapter` should I use? ------------------------------------------------------------------ -None of them, ideally. -A direct implementation of the storage APIs will almost certainly be able to perform better than any of these adapters. +In short: you should prefer direct implementations of the storage APIs +over any of these adapters, if one is available with the features you need. -Failing that: use the adapter matching whatever you've got on hand in your code. +Otherwise, if that's not an option (yet) for some reason, +use whichever adapter gets you most directly connected to the code you need. -There is no correct choice. - -dsadapter suffers avoidable excessive allocs in processing its key type, -due to choices in the interior of `github.com/ipfs/go-datastore`. -It is also unable to support streaming operation, should you desire it. - -bsadapter and bsrvadapter both also suffer overhead due to their key type, -because they require a transformation back from the plain binary strings used in the storage API to the concrete go-cid type, -which spends some avoidable CPU time (and also, at present, causes avoidable allocs because of some interesting absenses in `go-cid`). -Additionally, they suffer avoidable allocs because they wrap the raw binary data in a "block" type, -which is an interface, and thus heap-escapes; and we need none of that in the storage APIs, and just return the raw data. -They are also unable to support streaming operation, should you desire it. - -It's best to choose the shortest path and use the adapter to whatever layer you need to get to -- -for example, if you really want to use a `go-datastore` implementation, -*don't* use `bsadapter` and have it wrap a `go-blockstore` that wraps a `go-datastore` if you can help it: -instead, use `dsadapter` and wrap the `go-datastore` without any extra layers of indirection. -You should prefer this because most of the notes above about avoidable allocs are true when -the legacy interfaces are communicating with each other, as well... -so the less you use the internal layering of the legacy interfaces, the better off you'll be. - -Using a direct implementation of the storage APIs will suffer none of these overheads, -and so will always be your best bet if possible. - -If you have to use one of these adapters, hopefully the performance overheads fall within an acceptable margin. -If not: we'll be overjoyed to accept help porting things. +See `../README_adapters.md` for more details and discussion. diff --git a/storage/bsrvadapter/README.md b/storage/bsrvadapter/README.md index d8d6a04c..a7a1449f 100644 --- a/storage/bsrvadapter/README.md +++ b/storage/bsrvadapter/README.md @@ -19,40 +19,17 @@ Nonetheless: it's possible, using this code, if you really want to do it.) Why structured like this? ------------------------- -See similar discussion in the `../dsadapter` module. +See `../README_adapters.md` for details about why adapter code is needed, +why this is in a module, why it's here, etc. Which of `dsadapter` vs `bsadapter` vs `bsrvadapter` should I use? ------------------------------------------------------------------ -None of them, ideally. -A direct implementation of the storage APIs will almost certainly be able to perform better than any of these adapters. +In short: you should prefer direct implementations of the storage APIs +over any of these adapters, if one is available with the features you need. -Failing that: use the adapter matching whatever you've got on hand in your code. +Otherwise, if that's not an option (yet) for some reason, +use whichever adapter gets you most directly connected to the code you need. -There is no correct choice. - -dsadapter suffers avoidable excessive allocs in processing its key type, -due to choices in the interior of `github.com/ipfs/go-datastore`. -It is also unable to support streaming operation, should you desire it. - -bsadapter and bsrvadapter both also suffer overhead due to their key type, -because they require a transformation back from the plain binary strings used in the storage API to the concrete go-cid type, -which spends some avoidable CPU time (and also, at present, causes avoidable allocs because of some interesting absenses in `go-cid`). -Additionally, they suffer avoidable allocs because they wrap the raw binary data in a "block" type, -which is an interface, and thus heap-escapes; and we need none of that in the storage APIs, and just return the raw data. -They are also unable to support streaming operation, should you desire it. - -It's best to choose the shortest path and use the adapter to whatever layer you need to get to -- -for example, if you really want to use a `go-datastore` implementation, -*don't* use `bsadapter` and have it wrap a `go-blockstore` that wraps a `go-datastore` if you can help it: -instead, use `dsadapter` and wrap the `go-datastore` without any extra layers of indirection. -You should prefer this because most of the notes above about avoidable allocs are true when -the legacy interfaces are communicating with each other, as well... -so the less you use the internal layering of the legacy interfaces, the better off you'll be. - -Using a direct implementation of the storage APIs will suffer none of these overheads, -and so will always be your best bet if possible. - -If you have to use one of these adapters, hopefully the performance overheads fall within an acceptable margin. -If not: we'll be overjoyed to accept help porting things. +See `../README_adapters.md` for more details and discussion. diff --git a/storage/dsadapter/README.md b/storage/dsadapter/README.md index 1a4cf6ed..ab2edcfc 100644 --- a/storage/dsadapter/README.md +++ b/storage/dsadapter/README.md @@ -12,59 +12,17 @@ with go-ipld-prime storage APIs. Why structured like this? ------------------------- -Why are there layers of interface code? -The `go-ipld-prime/storage` interfaces are a newer generation, -and improves on several things vs `go-datastore`. (See other docs for that.) - -Why is this code in a shared place? -The glue code to connect `go-datastore` to the new `go-ipld-prime/storage` APIs -is fairly minimal, but there's also no reason for anyone to write it twice, -so we want to put it somewhere easy to share. - -Why does this code has its own go module? -A separate module is used because it's important that go-ipld-prime can be used -without forming a dependency on `go-datastore`. -(We want this so that there's a reasonable deprecation pathway -- it must be -possible to write new code that doesn't take on transitive dependencies to old code.) - -Why does this code exist here, in this git repo? -We put this separate module in the same git repo as `go-ipld-prime`... because we can. -Technically, neither this module nor the go-ipld-prime module depend on each other -- -they just have interfaces that are aligned with each other -- so it's very easy to -hold them as separate go modules in the same repo, even though that can otherwise sometimes be tricky. +See `../README_adapters.md` for details about why adapter code is needed, +why this is in a module, why it's here, etc. Which of `dsadapter` vs `bsadapter` vs `bsrvadapter` should I use? ------------------------------------------------------------------ -None of them, ideally. -A direct implementation of the storage APIs will almost certainly be able to perform better than any of these adapters. - -Failing that: use the adapter matching whatever you've got on hand in your code. - -There is no correct choice. - -dsadapter suffers avoidable excessive allocs in processing its key type, -due to choices in the interior of `github.com/ipfs/go-datastore`. -It is also unable to support streaming operation, should you desire it. - -bsadapter and bsrvadapter both also suffer overhead due to their key type, -because they require a transformation back from the plain binary strings used in the storage API to the concrete go-cid type, -which spends some avoidable CPU time (and also, at present, causes avoidable allocs because of some interesting absenses in `go-cid`). -Additionally, they suffer avoidable allocs because they wrap the raw binary data in a "block" type, -which is an interface, and thus heap-escapes; and we need none of that in the storage APIs, and just return the raw data. -They are also unable to support streaming operation, should you desire it. - -It's best to choose the shortest path and use the adapter to whatever layer you need to get to -- -for example, if you really want to use a `go-datastore` implementation, -*don't* use `bsadapter` and have it wrap a `go-blockstore` that wraps a `go-datastore` if you can help it: -instead, use `dsadapter` and wrap the `go-datastore` without any extra layers of indirection. -You should prefer this because most of the notes above about avoidable allocs are true when -the legacy interfaces are communicating with each other, as well... -so the less you use the internal layering of the legacy interfaces, the better off you'll be. +In short: you should prefer direct implementations of the storage APIs +over any of these adapters, if one is available with the features you need. -Using a direct implementation of the storage APIs will suffer none of these overheads, -and so will always be your best bet if possible. +Otherwise, if that's not an option (yet) for some reason, +use whichever adapter gets you most directly connected to the code you need. -If you have to use one of these adapters, hopefully the performance overheads fall within an acceptable margin. -If not: we'll be overjoyed to accept help porting things. +See `../README_adapters.md` for more details and discussion. From 125c81f4fc63c36380474d934c61d72ae58d9756 Mon Sep 17 00:00:00 2001 From: Eric Myhre Date: Sat, 30 Oct 2021 12:47:27 +0200 Subject: [PATCH 03/14] storage/fsstore: finish support for read direction. --- storage/fsstore/fsstore.go | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/storage/fsstore/fsstore.go b/storage/fsstore/fsstore.go index c2e5fe2f..79b70caa 100644 --- a/storage/fsstore/fsstore.go +++ b/storage/fsstore/fsstore.go @@ -7,6 +7,7 @@ import ( "encoding/hex" "fmt" "io" + "io/ioutil" "os" "path/filepath" ) @@ -96,6 +97,16 @@ func (store *Store) Has(ctx context.Context, key string) (bool, error) { return false, err } +// Get implements go-ipld-prime/storage.ReadableStorage.Get. +func (store *Store) Get(ctx context.Context, key string) ([]byte, error) { + f, err := store.GetStream(ctx, key) + if err != nil { + return nil, err + } + defer f.(io.Closer).Close() + return ioutil.ReadAll(f) +} + // Put implements go-ipld-prime/storage.WritableStorage.Put. func (store *Store) Put(ctx context.Context, key string, content []byte) error { // We can't improve much on what we get by wrapping the stream interface; @@ -116,6 +127,24 @@ func (store *Store) Put(ctx context.Context, key string, content []byte) error { return wrCommitter(key) } +// GetStream implements go-ipld-prime/storage.StreamingReadableStorage.GetStream. +// +// Note that the returned reader will also be an io.Closer; +// if the caller does not check for that, and call Close appropriately, as StreamingReadableStorage documents is appropriate, +// then there may be resource leaks. +func (store *Store) GetStream(ctx context.Context, key string) (io.Reader, error) { + if ctx.Err() != nil { + return nil, ctx.Err() + } + + // Figure out where we expect it to be. + destpath := store.pathForKey(key) + + // Open and return. + // TODO: we should normalize things like "not exists" errors before hurling them up the stack. + return os.OpenFile(destpath, os.O_RDONLY, 0) +} + // PutStream implements go-ipld-prime/storage.StreamingWritableStorage.PutStream. func (store *Store) PutStream(ctx context.Context) (io.Writer, func(string) error, error) { for { From ab1d2c7e7510ec49cb3d760700908319f8d71261 Mon Sep 17 00:00:00 2001 From: Eric Myhre Date: Sat, 30 Oct 2021 14:31:39 +0200 Subject: [PATCH 04/14] storage: introduce package of sharding functions. --- storage/fsstore/fsstore.go | 14 +--- storage/sharding/sharding.go | 107 ++++++++++++++++++++++++ storage/sharding/sharding.test | Bin 0 -> 3149339 bytes storage/sharding/sharding_bench_test.go | 22 +++++ storage/sharding/sharding_test.go | 60 +++++++++++++ 5 files changed, 192 insertions(+), 11 deletions(-) create mode 100644 storage/sharding/sharding.go create mode 100755 storage/sharding/sharding.test create mode 100644 storage/sharding/sharding_bench_test.go create mode 100644 storage/sharding/sharding_test.go diff --git a/storage/fsstore/fsstore.go b/storage/fsstore/fsstore.go index 79b70caa..a7ee43d8 100644 --- a/storage/fsstore/fsstore.go +++ b/storage/fsstore/fsstore.go @@ -10,6 +10,8 @@ import ( "io/ioutil" "os" "path/filepath" + + "github.com/ipld/go-ipld-prime/storage/sharding" ) // Store is implements storage.ReadableStorage and storage.WritableStorage, @@ -36,17 +38,7 @@ func (store *Store) InitDefaults(basepath string) error { func(raw string) string { return base32.StdEncoding.WithPadding(base32.NoPadding).EncodeToString([]byte(raw)) }, - func(key string, shards *[]string) { - l := len(key) - switch { - case l > 6: - *shards = append(*shards, key[l-7:l-4], key[l-4:l-1], key) - case l > 3: - *shards = append(*shards, "000", key[l-4:l-1], key) - default: - *shards = append(*shards, "000", "000", key) - } - }, + sharding.Shard_r133, ) } diff --git a/storage/sharding/sharding.go b/storage/sharding/sharding.go new file mode 100644 index 00000000..5ef3fef2 --- /dev/null +++ b/storage/sharding/sharding.go @@ -0,0 +1,107 @@ +/* + This package contains several useful readymade sharding functions, + which should plug nicely into most storage implementations. + + The API contract for a sharding function is: + + func(key string, shards *[]string) + + In other words, the return is actually by a pointer to a slice which will be mutated. + This API allows the calling code to hand in a slice with existing capacity, + and thus allows for sharding functions to work without allocations. + + There is not a named type for this contract, because we prefer that packages + implementing the storage APIs should be possible to write without + being required to import any code from the go-ipld-prime module. + However, the function type definition above can be seen in many packages. + + Not all packages use this API convention. The `fsstore` package does; + some other storage implementations don't use sharding functions because they don't need them; + most of the adapter packages which target older code do not, + because those modules have their own sharding APIs already. +*/ +package sharding + +// Shard_r133 is a sharding function which will return three hunks, +// the last of which is the full original key, +// and the first two of which are three bytes long. +// The prefix hunks are taken from the end of the original key, +// after skipping one byte. +// If the key is too short, padding of the ascii "0" character is used. +// +// (This somewhat odd-sounding procedure is a useful one in practice, +// because if applying it on a base32 string that's a CID or multihash (which is the typical usage), +// it avoids the uneven distribution of the trailing characters of a base32 string, +// and also avoids the uneven distribution of the prefixes of CIDs or mulithashes.) +// +// If the shards parameter is a pointer to a slice that starts at zero length +// and a capacity of at least 3, this function will operate with no allocations. +// +// Supposing the key is a base32 string (where each byte effectively contains 2^5 bits), +// if a sufficient range of keys is present that all shards are seen, +// each group of shards will contain (2^5)^3=32768 entries. +func Shard_r133(key string, shards *[]string) { + l := len(key) + switch { + case l > 6: + *shards = append(*shards, key[l-7:l-4], key[l-4:l-1], key) + case l > 3: + *shards = append(*shards, "000", key[l-4:l-1], key) + default: + *shards = append(*shards, "000", "000", key) + } +} + +// Shard_r133 is a sharding function which will return three hunks. +// It is very similar to Shard_r133, but with shorter hunks. +// The last hunk is the full original key, +// and the first two hunks are two bytes long each. +// The prefix hunks are taken from the end of the original key, +// after skipping one byte. +// If the key is too short, padding of the ascii "0" character is used. +// +// If the shards parameter is a pointer to a slice that starts at zero length +// and a capacity of at least 3, this function will operate with no allocations. +// +// Supposing the key is a base32 string (where each byte effectively contains 2^5 bits), +// if a sufficient range of keys is present that all shards are seen, +// each group of shards will contain (2^5)^2=1024 entries. +// (This is often a useful number in practice, because if one is mapping shards +// onto filesystem directories, 1024 entries is almost certainly going to fit +// efficiently within any filesystem format you're likely to encounter; +// 1024-within-1024 also means you'll see about a billion entries before +// directories on the second layer of sharding will contain more than 1024 files. +// (If we're assuming 1MB blocks of data asthe actual contents, that would be quite +// a few terabytes of storage, so this is a very nice balanced trade for +// most practical systems.)) +func Shard_r122(key string, shards *[]string) { + l := len(key) + switch { + case l > 4: + *shards = append(*shards, key[l-5:l-3], key[l-3:l-1], key) + case l > 2: + *shards = append(*shards, "00", key[l-3:l-1], key) + default: + *shards = append(*shards, "00", "00", key) + } +} + +// Shard_r12 is a sharding function which will return two hunks. +// The last hunk is the full original key, +// and the first hunk is two bytes long. +// The prefix is are taken from the end of the original key, +// after skipping one byte. +// If the key is too short, the first hunk is just the ascii characters "00" instead. +// +// If the shards parameter is a pointer to a slice that starts at zero length +// and a capacity of at least 2, this function will operate with no allocations. +// +func Shard_r12(key string, shards *[]string) { + l := len(key) + switch { + case l > 2: + *shards = append(*shards, key[l-3:l-1], key) + default: + *shards = append(*shards, "00", key) + } +} diff --git a/storage/sharding/sharding.test b/storage/sharding/sharding.test new file mode 100755 index 0000000000000000000000000000000000000000..bad1178f91b8c178be0a0d29e0285cce18402bc1 GIT binary patch literal 3149339 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

Ugl!Q&)ncZTNmA7~K}su4s>!!_tgs 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