@sidetree/cas-s3

This package contains an implementation of Content Addressable Storage used in Sidetree.

It contains:

- S3Cas: A CAS interface for AWS S3
- MockS3Cas: A Mock-CAS interface for AWS S3

Usage

``
npm install --save @sidetree/cas-s3
`

Development

`
git clone https://github.com/transmute-industries/sidetree.js.git && cd sidetree.js
npm install
`

Testing for this Module

`
cd packages/cas-s3
npm run test
`

By default the test for this package will use a the MockS3Cas
implementation to replicate the functionality of S3 on AWS.
To enable the AWS S3Cas module for testing the following two
actions are required.

1. Create a ~/.aws/credentials file
2. Enable the use of the S3Cas by editing the test file

Instructions

1. Create a ~/.aws/credentials file

To create the ~/.aws/credentials you will need to have the aws cli
tool, which can be installed from this repository: https://github.com/aws/aws-cli.

Once that is installed, run the aws configure command to create the file.

`
$ aws configure
AWS Access Key ID: MYACCESSKEY
AWS Secret Access Key: MYSECRETKEY
Default region name [us-west-2]: us-west-2
Default output format [None]: json
`

2. Enable the use of the S3Cas by editing the test file

To enable the S3Cas module for testing, the test file is located at src/S3Cas.spec.ts.
You must change the variable value of forceMock from true to false. An example
is shown below.

`
import { testSuite } from '@sidetree/cas';
import S3Cas from './S3Cas';
import MockS3Cas from './MockS3Cas';
import casConfig from './cas-config.json';
// import AWS object without services
import AWS from 'aws-sdk/global';

const forceMock = false; // This line

const config = new AWS.Config();
if (forceMock) {
console.warn('Using mock s3 interface for S3 tests');
} else if (!config.credentials) {
console.warn(
'No AWS credentials found in ~/.aws/credentials, using mock interace'
);
}

const cas =
config.credentials && !forceMock
? new S3Cas(casConfig.s3BucketName)
: new MockS3Cas();

testSuite(cas);
`

Note that you will need both the ~/.aws/credentials file and const forceMock = false;
for the S3 module to run.

Bucket Name

The default bucket name is sidetree-cas-s3-test. The value for this can be changed
in src/cas-config.json.

`
{
"s3BucketName": "sidetree-cas-s3-test"
}
``