About ◈ Prerequisites ◈ Installation ◈ Getting started ◈ Supporting the project ◈ Joining the discussion
Hive.go is a shared library that is used in the GoShimmer, Hornet and IOTA Core node software. This library contains shared:
- Data structures
- Utility methods
- Abstractions
This is beta software, so there may be performance and stability issues. Please report any issues in our issue tracker.
To use the library, you need to have at least version 1.13 of Go installed on your device.
To check if you have Go installed, run the following command:
go version
If Go is installed, you should see the version that's installed.
To install Hive.go and its dependencies, you can use one of the following options:
-
If you use Go modules, just import the packages that you want to use
import ( "github.com/iotaledger/hive.go/logger" "github.com/iotaledger/hive.go/node" )
-
To download the library from GitHub, use the
go get
commandgo get github.com/iotaledger/hive.go
After you've installed the library, you can use it in your project.
For example, to create a new logger
instance:
import "github.com/iotaledger/hive.go/logger"
log = logger.NewLogger('myNewLoggerName')
To replace the mutexes in the syncutils
package with Go deadlock, use the deadlock
build flag when compiling your program.
If this library has been useful to you and you feel like contributing, consider submitting a bug report, feature request or a pull request.
See our contributing guidelines for more information.
If you want to get involved in the community, need help with getting set up, have any issues related to the library or just want to discuss IOTA, Distributed Registry Technology (DRT), and IoT with other people, feel free to join our Discord.