Tahoe.SDMF.Internal.Share

Deal with details related to the structural layout of an SDMF share.

Documentation

hashSize :: Int

newtype HashChain

Constructors

HashChain

Fields

• hashChain :: [(Word16, ByteString)]

Instances

Eq HashChain

Defined in Tahoe.SDMF.Internal.Share

Methods

(==) :: HashChain -> HashChain -> Bool

(/=) :: HashChain -> HashChain -> Bool

Show HashChain

Defined in Tahoe.SDMF.Internal.Share

Methods

showsPrec :: Int -> HashChain -> ShowS

show :: HashChain -> String

showList :: [HashChain] -> ShowS

Semigroup HashChain

Defined in Tahoe.SDMF.Internal.Share

Methods

(<>) :: HashChain -> HashChain -> HashChain

sconcat :: NonEmpty HashChain -> HashChain

stimes :: Integral b => b -> HashChain -> HashChain

Binary HashChain

Defined in Tahoe.SDMF.Internal.Share

Methods

put :: HashChain -> Put

get :: Get HashChain

putList :: [HashChain] -> Put

data Share

Structured representation of a single version SDMF share.

See Tahoe-LAFS "mutable" specification document, section title "SDMF Slot Format".

Since the only version of SDMF that is specified uses version 0, this implicitly represents a version 0 SDMF. If new versions of SDMF are specified then new constructors may be added.

Constructors

Share

Fields

• shareSequenceNumber :: Word64

  sequence number. 2^64-1 must be handled specially, TBD

• shareRootHash :: ByteString

  R (root of share hash merkle tree)

• shareIV :: SDMF_IV

  The IV for encryption of share data.

• shareTotalShares :: Word8

  The total number of encoded shares (k).

• shareRequiredShares :: Word8

  The number of shares required for decoding (N).

• shareSegmentSize :: Word64

  The size of a single ciphertext segment. This differs from shareDataLength in that it includes padding.

• shareDataLength :: Word64

  The length of the original plaintext.

• shareVerificationKey :: Verification

  The 2048 bit "verification" RSA key.

• shareSignature :: ByteString

  The RSA signature of H('x00'+shareSequenceNumber+shareRootHash+shareIV+encoding parameters) where 'x00' gives the version of this share format (0) and the encoding parameters are a certain serialization of shareRequiredShares and shareTotalShares.

• shareHashChain :: HashChain

  The share numbers and shareRootHash values which are required to ... something about verification I dunno. XXX

• shareBlockHashTree :: MerkleTree ByteString SHA256d

  A merkle tree where leaves are the hashes of the blocks in this share.

• shareData :: ByteString

  The share data (erasure encoded ciphertext).

• shareEncryptedPrivateKey :: ByteString

  The encrypted 2048 bit "signature" RSA key.

Instances

Eq Share

Defined in Tahoe.SDMF.Internal.Share

Methods

(==) :: Share -> Share -> Bool

(/=) :: Share -> Share -> Bool

Show Share

Defined in Tahoe.SDMF.Internal.Share

Methods

showsPrec :: Int -> Share -> ShowS

show :: Share -> String

showList :: [Share] -> ShowS

Binary Share

Defined in Tahoe.SDMF.Internal.Share

Methods

put :: Share -> Put

get :: Get Share

putList :: [Share] -> Put

getSubjectPublicKeyInfo :: Get PublicKey

Read an X.509v3-encoded SubjectPublicKeyInfo structure carrying an ASN.1 DER encoded RSA public key.

signatureKeyToBytes :: PrivateKey -> ByteString

Encode a private key to the Tahoe-LAFS canonical bytes representation - X.509 SubjectPublicKeyInfo of the ASN.1 DER serialization of an RSA PublicKey.