+ A go library for using the + + I2P + + Simple Anonymous + Messaging ( + + SAM version 3.0 + + ) bridge. It + has support for all streaming features SAM version 3.2. +
++ This is widely used and easy to use, but thusfar, mostly by me. It sees a lot of + testing and no breaking changes to the API are expected. +
+go get github.com/eyedeekay/goSam
+
+
+ Client.Dial
+
+ implements
+
+ net.Dial
+
+ so you can use go’s library packages like http.
+
package main
+
+import (
+ "io"
+ "log"
+ "net/http"
+ "os"
+
+ "github.com/cryptix/goSam"
+)
+
+func main() {
+ // create a default sam client
+ sam, err := goSam.NewDefaultClient()
+ checkErr(err)
+
+ log.Println("Client Created")
+
+ // create a transport that uses SAM to dial TCP Connections
+ tr := &http.Transport{
+ Dial: sam.Dial,
+ }
+
+ // create a client using this transport
+ client := &http.Client{Transport: tr}
+
+ // send a get request
+ resp, err := client.Get("http://stats.i2p/")
+ checkErr(err)
+ defer resp.Body.Close()
+
+ log.Printf("Get returned %+v\n", resp)
+
+ // create a file for the response
+ file, err := os.Create("stats.html")
+ checkErr(err)
+ defer file.Close()
+
+ // copy the response to the file
+ _, err = io.Copy(file, resp.Body)
+ checkErr(err)
+
+ log.Println("Done.")
+}
+
+func checkErr(err error) {
+ if err != nil {
+ log.Fatal(err)
+ }
+}
+
++ This will make the SAM transport dialer the default for all HTTP clients. +
+package main
+
+import (
+ "io"
+ "log"
+ "net/http"
+ "os"
+
+ "github.com/cryptix/goSam"
+)
+
+func main() {
+ sam, err := goSam.NewDefaultClient()
+ checkErr(err)
+
+ log.Println("Client Created")
+
+ // create a transport that uses SAM to dial TCP Connections
+ httpClient := &http.Client{
+ Transport: &http.Transport{
+ Dial: sam.Dial,
+ },
+ }
+
+ http.DefaultClient = httpClient
+ return nil
+}
+
+func checkErr(err error) {
+ if err != nil {
+ log.Fatal(err)
+ }
+}
+
+
+ client
+
+ also implements a resolver compatible with
+
+
+ getlantern/go-socks5
+
+
+ ,
+ making it very easy to implement a SOCKS5 server.
+
package main
+
+import (
+ "flag"
+
+ "github.com/eyedeekay/goSam"
+ "github.com/getlantern/go-socks5"
+ "log"
+)
+
+var (
+ samaddr = flag.String("sam", "127.0.0.1:7656", "SAM API address to use")
+ socksaddr = flag.String("socks", "127.0.0.1:7675", "SOCKS address to use")
+)
+
+func main() {
+ sam, err := goSam.NewClient(*samaddr)
+ if err != nil {
+ panic(err)
+ }
+ log.Println("Client Created")
+
+ // create a transport that uses SAM to dial TCP Connections
+ conf := &socks5.Config{
+ Dial: sam.DialContext,
+ Resolver: sam,
+ }
+ server, err := socks5.New(conf)
+ if err != nil {
+ panic(err)
+ }
+
+ // Create SOCKS5 proxy on localhost port 8000
+ if err := server.ListenAndServe("tcp", *socksaddr); err != nil {
+ panic(err)
+ }
+}
++ A package for installing this on Debian is buildable, and a version for Ubuntu + is available as a PPA and mirrored via i2p. To build the deb package, from the + root of this repository with the build dependencies installed(git, i2p, go, + debuild) run the command +
+ debuild -us -uc
++ to produce an unsigned deb for personal use only. For packagers, +
+ debuild -S
++ will produce a viable source package for use with Launchpad PPA’s and other + similar systems. +
+
+ STREAM FORWARD
+
+ The MIT License (MIT)
+
+Copyright (c) 2014 Henry
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+