meta.go

package gobcy

import (
	"fmt"
	"strconv"
)

//GetMeta gets BlockCypher-stored metadata associated with
//the hash of the given blockchain object. "Kind" describes
//the blockchain object you're querying:
//  "addr" (for an address)
//  "tx" (for a transaction)
//  "block" (for a block)
//If private is false, will retrieve publicly stored metadata.
//If private is true, will retrieve privately stored metadata
//associated with your token.
func (api *API) GetMeta(hash string, kind string, private bool) (meta map[string]string, err error) {
	if kind != "addr" && kind != "tx" && kind != "block" {
		err = fmt.Errorf("Func GetMeta: kind an invalid type: '%v'. Needs to be 'addr', 'tx', or 'block'", kind)
		return
	}
	params := map[string]string{"private": strconv.FormatBool(private)}
	u, err := api.buildURL("/"+kind+"s/"+hash+"/meta", params)
	if err != nil {
		return
	}
	err = getResponse(u, &meta)
	return
}

//PutMeta puts BlockCypher-stored metadata associated with
//the hash of the given blockchain object. "Kind" describes
//the blockchain object you're querying:
//  "addr" (for an address)
//  "tx" (for a transaction)
//  "block" (for a block)
//If private is false, will set publicly stored metadata.
//If private is true, will set privately stored metadata
//associated with your token.
func (api *API) PutMeta(hash string, kind string, private bool, meta map[string]string) (err error) {
	if kind != "addr" && kind != "tx" && kind != "block" {
		err = fmt.Errorf("Func PutMeta: kind an invalid type: '%v'. Needs to be 'addr', 'tx', or 'block'", kind)
		return
	}
	params := map[string]string{"private": strconv.FormatBool(private)}
	u, err := api.buildURL("/"+kind+"s/"+hash+"/meta", params)
	if err != nil {
		return
	}
	err = putResponse(u, &meta)
	return
}

//DeleteMeta deletes ALL PRIVATE BlockCypher-stored metadata
//associated with the hash of the given blockchain object.
//"Kind" describes the blockchain object you're querying:
//  "addr" (for an address)
//  "tx" (for a transaction)
//  "block" (for a block)
//Public metadata cannot be deleted; it is immutable.
func (api *API) DeleteMeta(hash string, kind string) (err error) {
	if kind != "addr" && kind != "tx" && kind != "block" {
		err = fmt.Errorf("Func DeleteMeta: kind an invalid type: '%v'. Needs to be 'addr', 'tx', or 'block'", kind)
		return
	}
	u, err := api.buildURL("/"+kind+"s/"+hash+"/meta", nil)
	if err != nil {
		return
	}
	err = deleteResponse(u)
	return
}