GNUnet Signature Purposes#

GNUnet signature purpose registry.

Every time a signature is created or verified with libgnunetutil’s signature functions, the signer must provide a “purpose” that provides the context for the signature. By signing over the “purpose”, it is not possible for an adversary to use a signature made in one context in another context.

Policy#

Developers working on GNUnet or packages based on GNUnet should feel free to extend this registry. Entries may be deleted if no code using them is still expected to be in production anywhere.

Updating the name of the package or subsystem is allowed provided that the code using the signature is being moved, as those fields are merely informational or used for code generation.

Entries#

GNS Signature Purposes#

Name

Number

Package

Subsystem

Comment

TEST

0

GNUnet

GNUnet

Test signature, not valid for anything other than writing a test. (Note that the signature verification code will accept this value).

TRANSPORT_PONG_OWN

1

GNUnet

GNUnet-TRANSPORT

Signature for confirming that this peer uses a particular address.

TRANSPORT_DISCONNECT

2

GNUnet

GNUnet-TRANSPORT

Signature for confirming that this peer intends to disconnect.

GNS_REVOCATION

3

GNUnet

GNS

GNS zone key revocation

NAMESPACE_ADVERTISEMENT

4

GNUnet

GNUnet-FS

Signature for a namespace/pseudonym advertisement (by the namespace owner).

PEER_PLACEMENT

5

GNUnet

GNUnet-FS

Signature by which a peer affirms that it is providing a certain bit of content for use in LOCation URIs.

DHT_HOP

6

GNUnet

GNUnet-DHT

Signature by which a peer affirms that it forwarded a message in the DHT.

HELLO

7

GNUnet

GNUnet-HELLO

Signature by which a peer affirms its address.

DNS_RECORD

11

GNUnet

GNUnet-DNS+Exit

Signature on a GNUNET_DNS_Advertisement.

CHAT_MESSAGE

12

GNUnet

GNUnet-MESSENGER

Signature of a chat message.

CHAT_RECEIPT

13

GNUnet

GNUnet-MESSENGER

Signature of confirmation receipt for a chat message.

NSE_SEND

14

GNUnet

GNUnet-NSE

Signature of a network size estimate message.

GNS_RECORD_SIGN

15

GNUnet

GNS

GNS record set signature

SET_ECC_KEY

16

GNUnet

GNUnet-CORE

Purpose is to set a session key.

FS_UBLOCK

17

GNUnet

GNUnet-FS

UBlock Signature, done using DSS, not ECC

REGEX_ACCEPT

18

GNUnet

GNUnet-REGEX

Accept state in regex DFA. Peer affirms that it offers the matching service.

CONVERSATION_RING

20

GNUnet

GNUnet-CONVERSATION

Signature of a conversation ring.

SECRETSHARING_DKG1

21

GNUnet

GNUnet-SECRETSHARING

Signature for the first round of distributed key generation.

SECRETSHARING_DKG2

22

GNUnet

GNUnet-SECRETSHARING

Signature for the second round of distributed key generation.

SECRETSHARING_DECRYPTION

23

GNUnet

GNUnet-SECRETSHARING

Signature for the cooperative decryption.

RECLAIM_CODE_SIGN

27

GNUnet

Reclaim

Signature for a GNUid Ticket

DELEGATE

28

GNUnet

Reclaim

Signature for a GNUnet credential

TRANSPORT_ADDRESS

29

GNUnet

GNUnet-TRANSPORT

Signature by a peer affirming that this is one of its addresses for the given time period.

TRANSPORT_EPHEMERAL

30

GNUnet

GNUnet-TRANSPORT

Signature by a peer affirming that the given ephemeral key is currently in use by that peer’s transport service.

COMMUNICATOR_TCP_HANDSHAKE

31

GNUnet

GNUnet-TRANSPORT-TCP

Signature used by TCP communicator handshake.

COMMUNICATOR_TCP_REKEY

32

GNUnet

GNUnet-TRANSPORT-TCP

Signature used by TCP communicator rekey.

COMMUNICATOR_UDP_HANDSHAKE

33

GNUnet

GNUnet-TRANSPORT-UDP

Signature used by UDP communicator handshake.

COMMUNICATOR_UDP_BROADCAST

34

GNUnet

GNUnet-TRANSPORT-UDP

Signature used by UDP broadcasts.

TRANSPORT_CHALLENGE

35

GNUnet

GNUnet-TRANSPORT

Signature by a peer affirming that it received a challenge (and stating how long it expects the address on which the challenge was received to remain valid).

TRANSPORT_DV_HOP

36

GNUnet

GNUnet-TRANSPORT

Signature by a peer affirming that it is on a DV path.

TRANSPORT_DV_INITIATOR

37

GNUnet

GNUnet-TRANSPORT

Signature by a peer affirming that it originated the DV path.

CADET_CONNECTION_INITIATOR

38

GNUnet

GNUnet-CADET

Signature by a peer that like to create a connection.

COMMUNICATOR_TCP_HANDSHAKE_ACK

39

GNUnet

GNUnet-TRANSPORT-TCP

Signature by a peer sending back the nonce received at initial handshake.