Namecoin

Namecoin utility library

JSON-RPC client

data RPCRequest

JSON-RPC 1.0 request record

Constructors

RPCRequest

Fields

• id :: String

  a string identificating the client

• method :: String

  the name of the method

• params :: [String]

  a list of parameters for the method

Instances

FromJSON RPCRequest

Defined in Namecoin

Methods

parseJSON :: Value -> Parser RPCRequest

parseJSONList :: Value -> Parser [RPCRequest]

ToJSON RPCRequest

Defined in Namecoin

Methods

toJSON :: RPCRequest -> Value

toEncoding :: RPCRequest -> Encoding

toJSONList :: [RPCRequest] -> Value

toEncodingList :: [RPCRequest] -> Encoding

Generic RPCRequest

Defined in Namecoin

Associated Types

type Rep RPCRequest :: Type -> Type

Methods

from :: RPCRequest -> Rep RPCRequest x

to :: Rep RPCRequest x -> RPCRequest

type Rep RPCRequest

Defined in Namecoin

type Rep RPCRequest = D1 ('MetaData "RPCRequest" "Namecoin" "namecoin-update-0.2.3.0-inplace" 'False) (C1 ('MetaCons "RPCRequest" 'PrefixI 'True) (S1 ('MetaSel ('Just "id") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 String) :*: (S1 ('MetaSel ('Just "method") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 String) :*: S1 ('MetaSel ('Just "params") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 [String]))))

data RPCResponse

JSON-RPC 1.0 response record

Constructors

RPCResponse

Fields

• id :: String

  the same identificative string

• result :: Value

  result if the method call succeded

• rpcError :: Maybe RPCError

  error in case the method call failed

Instances

FromJSON RPCResponse

Defined in Namecoin

Methods

parseJSON :: Value -> Parser RPCResponse

parseJSONList :: Value -> Parser [RPCResponse]

ToJSON RPCResponse

Defined in Namecoin

Methods

toJSON :: RPCResponse -> Value

toEncoding :: RPCResponse -> Encoding

toJSONList :: [RPCResponse] -> Value

toEncodingList :: [RPCResponse] -> Encoding

Generic RPCResponse

Defined in Namecoin

Associated Types

type Rep RPCResponse :: Type -> Type

Methods

from :: RPCResponse -> Rep RPCResponse x

to :: Rep RPCResponse x -> RPCResponse

type Rep RPCResponse

Defined in Namecoin

type Rep RPCResponse = D1 ('MetaData "RPCResponse" "Namecoin" "namecoin-update-0.2.3.0-inplace" 'False) (C1 ('MetaCons "RPCResponse" 'PrefixI 'True) (S1 ('MetaSel ('Just "id") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 String) :*: (S1 ('MetaSel ('Just "result") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Value) :*: S1 ('MetaSel ('Just "rpcError") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 (Maybe RPCError)))))

data RPCError

Namecoin API error record

Constructors

RPCError

Fields

• code :: Int

  a number indicating the kind of error

• message :: String

  a detailed explanation of the error

Instances

FromJSON RPCError

Defined in Namecoin

Methods

parseJSON :: Value -> Parser RPCError

parseJSONList :: Value -> Parser [RPCError]

ToJSON RPCError

Defined in Namecoin

Methods

toJSON :: RPCError -> Value

toEncoding :: RPCError -> Encoding

toJSONList :: [RPCError] -> Value

toEncodingList :: [RPCError] -> Encoding

Generic RPCError

Defined in Namecoin

Associated Types

type Rep RPCError :: Type -> Type

Methods

from :: RPCError -> Rep RPCError x

to :: Rep RPCError x -> RPCError

type Rep RPCError

Defined in Namecoin

type Rep RPCError = D1 ('MetaData "RPCError" "Namecoin" "namecoin-update-0.2.3.0-inplace" 'False) (C1 ('MetaCons "RPCError" 'PrefixI 'True) (S1 ('MetaSel ('Just "code") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Int) :*: S1 ('MetaSel ('Just "message") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 String)))

rpcRequest

Arguments

:: String

the URI of the JSON-RPC endpoint

-> String

the method name

-> [String]

the method parameters

-> IO (Error Value)

and error or the wanted result

Execute an RPC method

Name operations

data Name

Namecoin API Value record

Constructors

Name

Fields

• name :: String

  the namecoin name

• value :: String

  its value

• expires_in :: Int

  number of blocks before the name expires

Instances

FromJSON Name

Defined in Namecoin

Methods

parseJSON :: Value -> Parser Name

parseJSONList :: Value -> Parser [Name]

Generic Name

Defined in Namecoin

Associated Types

type Rep Name :: Type -> Type

Methods

from :: Name -> Rep Name x

to :: Rep Name x -> Name

Show Name

Defined in Namecoin

Methods

showsPrec :: Int -> Name -> ShowS

show :: Name -> String

showList :: [Name] -> ShowS

type Rep Name

Defined in Namecoin

type Rep Name = D1 ('MetaData "Name" "Namecoin" "namecoin-update-0.2.3.0-inplace" 'False) (C1 ('MetaCons "Name" 'PrefixI 'True) (S1 ('MetaSel ('Just "name") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 String) :*: (S1 ('MetaSel ('Just "value") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 String) :*: S1 ('MetaSel ('Just "expires_in") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Int))))

nameList :: String -> IO (Error [Name])

Returns the list of currently registered names

nameUpdate :: String -> Name -> IO Int

Issue an udpate for a name (confirming its current value)

Miscellanea

uri :: Text -> Error String

Takes the content of a namecoin config file and gives the URI to connect to the JSON-RPC server