Class S3Blockstore

A blockstore backed by AWS S3

Hierarchy (View Summary)

BaseBlockstore
- S3Blockstore

Index

Constructors

constructor

new S3Blockstore(s3: S3, bucket: string, init?: S3BlockstoreInit): S3Blockstore
Parameters
- s3: S3
- bucket: string
- Optionalinit: S3BlockstoreInit
Returns S3Blockstore
Overrides BaseBlockstore.constructor
- Defined in blockstore-s3/src/index.ts:75

Properties

createIfMissing

createIfMissing: boolean

Methods

delete

delete(key: CID, options?: AbortOptions): Promise<void>
Delete the record under the given key
Parameters
- key: CID
- Optionaloptions: AbortOptions
Returns Promise<void>
Overrides BaseBlockstore.delete
- Defined in blockstore-s3/src/index.ts:198

deleteMany

deleteMany(
source: AwaitIterable<CID<unknown, number, number, Version>>,
options?: AbortOptions,
): AwaitGenerator<CID<unknown, number, number, Version>>
Remove values for the passed keys
Parameters
- source: AwaitIterable<CID<unknown, number, number, Version>>
- Optionaloptions: AbortOptions
Returns AwaitGenerator<CID<unknown, number, number, Version>>
Example
```
const source = [new Key('awesome')]

for await (const key of store.deleteMany(source)) {
  console.log(`deleted content with key ${key}`)
}
```
Inherited from BaseBlockstore.deleteMany
- Defined in blockstore-core/dist/src/base.d.ts:11

get

get(
key: CID,
options?: AbortOptions,
): AwaitGenerator<Uint8Array<ArrayBufferLike>>
Read from s3
Parameters
- key: CID
- Optionaloptions: AbortOptions
Returns AwaitGenerator<Uint8Array<ArrayBufferLike>>
Overrides BaseBlockstore.get
- Defined in blockstore-s3/src/index.ts:117

getAll

getAll(options?: AbortOptions): AwaitGenerator<Pair>
Extending classes should override query or implement this method
Parameters
- Optionaloptions: AbortOptions
Returns AwaitGenerator<Pair>
Overrides BaseBlockstore.getAll
- Defined in blockstore-s3/src/index.ts:214

getMany

getMany(
source: AwaitIterable<CID<unknown, number, number, Version>>,
options?: AbortOptions,
): AwaitGenerator<Pair>
Retrieve values for the passed keys
Parameters
- source: AwaitIterable<CID<unknown, number, number, Version>>
- Optionaloptions: AbortOptions
Returns AwaitGenerator<Pair>
Example
```
for await (const { key, value } of store.getMany([new Key('awesome')])) {
  console.log(`got "${key}" = "${new TextDecoder('utf8').decode(value)}"`')
  // => got "/awesome" = "datastore"
}
```
Inherited from BaseBlockstore.getMany
- Defined in blockstore-core/dist/src/base.d.ts:9

has

has(key: CID, options?: AbortOptions): Promise<boolean>
Check for the existence of the given key
Parameters
- key: CID
- Optionaloptions: AbortOptions
Returns Promise<boolean>
Overrides BaseBlockstore.has
- Defined in blockstore-s3/src/index.ts:167

open

open(options?: AbortOptions): Promise<void>
This will check the s3 bucket to ensure access and existence
Parameters
- Optionaloptions: AbortOptions
Returns Promise<void>
- Defined in blockstore-s3/src/index.ts:271

put

put(
    key: CID,
    val: Uint8Array,
    options?: AbortOptions,
): Promise<CID<unknown, number, number, Version>>
Store the given value under the key.
Parameters
- key: CID
- val: Uint8Array
- Optionaloptions: AbortOptions
Returns Promise<CID<unknown, number, number, Version>>
Overrides BaseBlockstore.put
- Defined in blockstore-s3/src/index.ts:95

putMany

putMany(
source: AwaitIterable<InputPair>,
options?: AbortOptions,
): AwaitGenerator<CID<unknown, number, number, Version>>
Store the given key/value pairs
Parameters
- source: AwaitIterable<InputPair>
- Optionaloptions: AbortOptions
Returns AwaitGenerator<CID<unknown, number, number, Version>>
Example
```
const source = [{ key: new Key('awesome'), value: new Uint8Array([0, 1, 2, 3]) }]

for await (const { key, value } of store.putMany(source)) {
  console.info(`put content for key ${key}`)
}
```
Inherited from BaseBlockstore.putMany
- Defined in blockstore-core/dist/src/base.d.ts:7

Class S3Blockstore

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns S3Blockstore

Properties

createIfMissing

Methods

delete

Parameters

Returns Promise<void>

deleteMany

Parameters

Returns AwaitGenerator<CID<unknown, number, number, Version>>

Example

get

Parameters

Returns AwaitGenerator<Uint8Array<ArrayBufferLike>>

getAll

Parameters

Returns AwaitGenerator<Pair>

getMany

Parameters

Returns AwaitGenerator<Pair>

Example

has

Parameters

Returns Promise<boolean>

open

Parameters

Returns Promise<void>

put

Parameters

Returns Promise<CID<unknown, number, number, Version>>

putMany

Parameters

Returns AwaitGenerator<CID<unknown, number, number, Version>>

Example

Settings

On This Page